> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Resume Share

> Create a public share link for a resume

## Overview

Generate a public share link for a resume. The endpoint **snapshots** the resume's current cvData, design settings, section order and optional fields into a `EmpResumeShare` row so the shared page renders the state at share-creation time, independent of later edits to the underlying resume.

If a share already exists for this resume, the existing link is returned (upsert behaviour).

**Common use cases:**

* **Send your CV without a PDF** - share a live web URL instead of attaching a file.
* **Privacy-respecting share** - blur company names, institutions, LinkedIn, etc. via `blurOptions`.
* **AI agent application flow** - autofill the recruiter's contact form with a Mokaru share link.

<Note>
  **Scope required:** `resume:share` | **Rate limit:** 10 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/resume/{id}/share
```

### Path Parameters

<ParamField path="id" type="string" required>Resume id to share.</ParamField>

### Body Parameters

<ParamField body="blurOptions" type="object">
  Privacy toggles. Each truthy key blurs the corresponding field on the public view.

  <Expandable>
    <ResponseField name="blurLinkedIn" type="boolean">Blur the LinkedIn URL.</ResponseField>
    <ResponseField name="blurWebsite" type="boolean">Blur the website URL.</ResponseField>
    <ResponseField name="blurPortfolio" type="boolean">Blur the portfolio URL.</ResponseField>
    <ResponseField name="blurCompanies" type="boolean">Blur every company name on the CV.</ResponseField>
    <ResponseField name="blurInstitutions" type="boolean">Blur every school / institution name.</ResponseField>
  </Expandable>
</ParamField>

### Example

```bash theme={null}
curl -X POST "https://api.mokaru.ai/v1/resume/clx1234/share" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "blurOptions": { "blurCompanies": true } }'
```

## Response

<ResponseField name="success" type="boolean">Whether the share was created (or returned).</ResponseField>
<ResponseField name="shareId" type="string">Share row ID (used in the URL).</ResponseField>
<ResponseField name="shareUrl" type="string">Public URL, e.g. `https://app.mokaru.ai/share/abc123`.</ResponseField>
<ResponseField name="createdAt" type="string">ISO 8601 timestamp of when this share was originally created.</ResponseField>
<ResponseField name="reused" type="boolean">`true` if an existing share for this resume was returned instead of creating a new one.</ResponseField>

```json theme={null}
{
  "success": true,
  "shareId": "clx_share_abc",
  "shareUrl": "https://app.mokaru.ai/share/clx_share_abc",
  "createdAt": "2026-05-21T10:00:00.000Z",
  "reused": false
}
```