> ## 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

> Create a new resume

## Overview

The Create Resume endpoint lets you create a new resume in Mokaru. You can provide the full content (experiences, skills, etc.) or create an empty resume to fill in later.

**Common use cases:**

* **AI agent resume creation** - let your AI agent create tailored resumes for specific job applications.
* **Bulk resume generation** - create multiple resume variants targeting different roles or industries.
* **Import from external sources** - pull data from LinkedIn, another tool, or a parsed PDF and create a Mokaru resume.

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

## Request

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

### Body Parameters

<ParamField body="name" type="string" required>
  Resume name (max 200 characters)
</ParamField>

<ParamField body="template" type="string" default="classic">
  Template ID (e.g. "classic", "modern", "minimal")
</ParamField>

<ParamField body="isDefault" type="boolean" default="false">
  Set as the default resume (unsets any existing default)
</ParamField>

<ParamField body="cvData" type="object">
  Resume content: personal info, experiences, education, skills, languages, certificates, projects
</ParamField>

<ParamField body="designSettings" type="object">
  Visual styling: colors, fonts, spacing, margins
</ParamField>

<ParamField body="optionalFields" type="object">
  Show/hide toggles for optional fields like phone, address, photo
</ParamField>

<ParamField body="sectionOrder" type="array">
  Order of resume sections (e.g. \["personal", "experience", "education", "skills"])
</ParamField>

### Example

```bash theme={null}
curl -X POST "https://api.mokaru.ai/v1/resume" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Engineer Resume",
    "template": "classic",
    "isDefault": false,
    "cvData": {
      "firstName": "Jane",
      "lastName": "Doe",
      "jobTitle": "Backend Engineer"
    }
  }'
```

## Response

<ResponseField name="success" type="boolean">Whether the resume was created</ResponseField>
<ResponseField name="id" type="string">The new resume's unique ID</ResponseField>

```json theme={null}
{
  "success": true,
  "id": "clx1234..."
}
```