Skip to main content
POST
/
v1
/
resume
Create Resume
curl --request POST \
  --url https://api.mokaru.ai/v1/resume \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "template": "<string>",
  "isDefault": true,
  "cvData": {},
  "designSettings": {},
  "optionalFields": {},
  "sectionOrder": [
    {}
  ]
}
'
{
  "success": true,
  "id": "<string>"
}

​
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.
Scope required: resume:write | Rate limit: 10 requests/min

​
Request

POST /v1/resume

​
Body Parameters

​
name
string
required
Resume name (max 200 characters)
​
template
string
default:"classic"
Template ID (e.g. “classic”, “modern”, “minimal”)
​
isDefault
boolean
default:"false"
Set as the default resume (unsets any existing default)
​
cvData
object
Resume content: personal info, experiences, education, skills, languages, certificates, projects
​
designSettings
object
Visual styling: colors, fonts, spacing, margins
​
optionalFields
object
Show/hide toggles for optional fields like phone, address, photo
​
sectionOrder
array
Order of resume sections (e.g. [“personal”, “experience”, “education”, “skills”])

​
Example

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

​
success
boolean
Whether the resume was created
​
id
string
The new resume’s unique ID
{
  "success": true,
  "id": "clx1234..."
}