Create Resume

curl --request POST \
  --url https://api.mokaru.ai/v1/resume \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "jobTitle": "<string>",
  "template": "<string>",
  "isDefault": true,
  "cvData": {},
  "hiddenItems": {},
  "personalOverrides": {},
  "itemOrder": {},
  "selectedSummaryId": "<string>",
  "designSettings": {},
  "optionalFields": {},
  "sectionOrder": [
    {}
  ]
}
'

import requests

url = "https://api.mokaru.ai/v1/resume"

payload = {
    "name": "<string>",
    "jobTitle": "<string>",
    "template": "<string>",
    "isDefault": True,
    "cvData": {},
    "hiddenItems": {},
    "personalOverrides": {},
    "itemOrder": {},
    "selectedSummaryId": "<string>",
    "designSettings": {},
    "optionalFields": {},
    "sectionOrder": [{}]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    jobTitle: '<string>',
    template: '<string>',
    isDefault: true,
    cvData: {},
    hiddenItems: {},
    personalOverrides: {},
    itemOrder: {},
    selectedSummaryId: '<string>',
    designSettings: {},
    optionalFields: {},
    sectionOrder: [{}]
  })
};

fetch('https://api.mokaru.ai/v1/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mokaru.ai/v1/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'jobTitle' => '<string>',
    'template' => '<string>',
    'isDefault' => true,
    'cvData' => [
        
    ],
    'hiddenItems' => [
        
    ],
    'personalOverrides' => [
        
    ],
    'itemOrder' => [
        
    ],
    'selectedSummaryId' => '<string>',
    'designSettings' => [
        
    ],
    'optionalFields' => [
        
    ],
    'sectionOrder' => [
        [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mokaru.ai/v1/resume"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mokaru.ai/v1/resume")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mokaru.ai/v1/resume")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "id": "<string>"
}

POST

resume

Create Resume

curl --request POST \
  --url https://api.mokaru.ai/v1/resume \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "jobTitle": "<string>",
  "template": "<string>",
  "isDefault": true,
  "cvData": {},
  "hiddenItems": {},
  "personalOverrides": {},
  "itemOrder": {},
  "selectedSummaryId": "<string>",
  "designSettings": {},
  "optionalFields": {},
  "sectionOrder": [
    {}
  ]
}
'

import requests

url = "https://api.mokaru.ai/v1/resume"

payload = {
    "name": "<string>",
    "jobTitle": "<string>",
    "template": "<string>",
    "isDefault": True,
    "cvData": {},
    "hiddenItems": {},
    "personalOverrides": {},
    "itemOrder": {},
    "selectedSummaryId": "<string>",
    "designSettings": {},
    "optionalFields": {},
    "sectionOrder": [{}]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    jobTitle: '<string>',
    template: '<string>',
    isDefault: true,
    cvData: {},
    hiddenItems: {},
    personalOverrides: {},
    itemOrder: {},
    selectedSummaryId: '<string>',
    designSettings: {},
    optionalFields: {},
    sectionOrder: [{}]
  })
};

fetch('https://api.mokaru.ai/v1/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mokaru.ai/v1/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'jobTitle' => '<string>',
    'template' => '<string>',
    'isDefault' => true,
    'cvData' => [
        
    ],
    'hiddenItems' => [
        
    ],
    'personalOverrides' => [
        
    ],
    'itemOrder' => [
        
    ],
    'selectedSummaryId' => '<string>',
    'designSettings' => [
        
    ],
    'optionalFields' => [
        
    ],
    'sectionOrder' => [
        [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mokaru.ai/v1/resume"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mokaru.ai/v1/resume")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mokaru.ai/v1/resume")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"template\": \"<string>\",\n  \"isDefault\": true,\n  \"cvData\": {},\n  \"hiddenItems\": {},\n  \"personalOverrides\": {},\n  \"itemOrder\": {},\n  \"selectedSummaryId\": \"<string>\",\n  \"designSettings\": {},\n  \"optionalFields\": {},\n  \"sectionOrder\": [\n    {}\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "id": "<string>"
}

Overview

The Create Resume endpoint lets you create a new resume in Mokaru. Each resume owns its own content. A new resume starts as a copy of your base (default) resume’s content (experiences, education, skills, certificates, projects, awards, publications and interests); editing the base afterwards doesn’t change resumes you already created. Use this endpoint for the CV-level shell (name, template, design) and to hide items on the CV via hiddenItems. Common use cases:

AI agent resume creation - create a tailored resume for a specific job by hiding items that aren’t relevant.
Bulk resume generation - create multiple resume variants with different hiddenItems selections.
Set defaults - create the user’s first resume, copied from the base resume’s content.

Self-contained model: sections (experiences, education, skills, certificates, projects, awards, publications, interests, customSections) are managed via the dedicated content endpoints (e.g. POST /v1/experiences), not via cvData. Arrays under these keys in cvData are silently dropped to prevent the resume thumbnail from drifting from what the builder shows. The new resume’s content is copied from the base resume at create time; use hiddenItems to hide items on this specific CV.

Scope required: resume:write | Rate limit: 10 requests/min

Request

POST /v1/resume

Body Parameters

string

required

Resume name (max 200 characters)

string

CV-level job title shown in the header (max 150 chars). Overrides the shared identity job title for this CV. Pass null to clear and fall back to the identity value.

string

default:"classic"

Template ID (e.g. “classic”, “modern”, “minimal”)

boolean

default:"false"

Set as the default resume (unsets any existing default)

object

CV-level overrides for personal info and summary. Section arrays (experiences, education, skills, certificates, projects, awards, publications, interests, customSections) are silently ignored - use the dedicated content endpoints to manage them, and hiddenItems to hide them per-CV.

object

Per-section blacklist of the resume’s item IDs to hide on this CV. Items not listed are visible. Keys: experiences, education, skills, certificates, projects, awards, publications, interests, or customSection:<definitionId>. Each value is an array of the resume’s item IDs (from the content endpoints / GET /v1/profile).

object

Per-CV content override. Only summary takes effect - it overrides the selected summary for this CV (pass null to clear). Identity fields (name, email, phone, address, links, photo) are shared profile-level and cannot be overridden per resume; edit them via the profile endpoint. The per-CV job title is the top-level jobTitle field, not personalOverrides.

object

Per-section ordering map. Keys are section names (experiences, education, skills, certificates, projects, awards, publications, interests, skillCategories); values are arrays of the resume’s item IDs in the desired order. Items not listed fall back to the default order.

string

ID of the summary this resume shows (from GET /v1/summaries). Set to null to render no summary.

object

Visual styling: colors, fonts, spacing, margins

object

Show/hide toggles for optional fields like phone, address, photo

array

Order of resume sections (e.g. [“summary”, “experiences”, “education”, “skills”])

Example

Create a resume that hides two of the resume’s experiences and one project:

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": {
      "jobTitle": "Backend Engineer"
    },
    "hiddenItems": {
      "experiences": ["clx_exp_oldjob1", "clx_exp_oldjob2"],
      "projects": ["clx_proj_sidegig"]
    }
  }'

Response

boolean

Whether the resume was created

string

The new resume’s unique ID

{
  "success": true,
  "id": "clx1234..."
}

Get Resume Update Resume

API Reference

Jobs

Applications

Contacts

Experiences

Education

Skills

Resumes

Resume Sharing

Cover Letters

Profile

Summaries

Projects

Certificates

Awards

Publications

Interests

Custom Sections

Create Resume

Overview

Request

Body Parameters

Example

Response

​Overview

​Request

​Body Parameters

​Example

​Response

Overview

Request

Body Parameters

Example

Response