Skip to main content
PATCH
/
v1
/
profile
Update Profile
curl --request PATCH \
  --url https://api.mokaru.ai/v1/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "phone": {},
  "address": {},
  "country": {},
  "province": {},
  "birthDate": {},
  "driverLicense": {},
  "gender": {},
  "jobTitle": {},
  "summary": {},
  "sector": {},
  "employer": {},
  "linkedIn": {},
  "website": {},
  "portfolio": {},
  "summaries": {},
  "projects": {},
  "certificates": {},
  "awards": {},
  "publications": {},
  "interests": {},
  "jobTitles": {}
}
'
{
  "success": true
}

​
Overview

The Update Profile endpoint lets you modify your career profile. The scalar identity and contact fields (name, email, phone, address, links, and the profile scalars below) are shared and appear on every resume - editing them here propagates to all resumes. The collection arrays (summaries, projects, certificates, etc.) write your base (default) resume’s content, which is the canonical content that new resumes are copied from. Common use cases:
  • AI agent profile management - keep your profile up to date as your career evolves.
  • Bulk updates - update multiple fields at once after a job change.
  • LinkedIn sync - pull data from LinkedIn and push it to your Mokaru profile.
Scope required: profile:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/profile

​
Body Parameters

All fields are optional. Only include the fields you want to change. Pass null to clear a field.
​
firstName
string
First name (max 100 characters)
​
lastName
string
Last name (max 100 characters)
​
email
string
Email address (max 254 characters)
​
phone
string | null
Phone number (max 50 characters, null to clear)
​
address
string | null
Address (max 200 characters, null to clear)
​
country
string | null
Country (max 100 characters, null to clear)
​
province
string | null
Province or state (max 100 characters, null to clear)
​
birthDate
string | null
Birth date in ISO format, e.g. “1990-01-15” (null to clear)
​
driverLicense
string | null
Driver license type (max 50 characters, null to clear)
​
gender
string | null
Gender (max 50 characters, null to clear)
​
jobTitle
string | null
Current job title (max 200 characters, null to clear)
​
summary
string | null
Professional summary (max 2000 characters, null to clear)
​
sector
string | null
Industry sector (max 100 characters, null to clear)
​
employer
string | null
Current employer (max 200 characters, null to clear)
​
linkedIn
string | null
LinkedIn username or URL. Automatically normalized to a full URL. (null to clear)
​
website
string | null
Personal website URL. https:// is added if missing. (max 500 characters, null to clear)
​
portfolio
string | null
Portfolio URL. https:// is added if missing. (max 500 characters, null to clear)

​
Collection fields (replace-list semantics)

These accept full arrays. Passing an array REPLACES the entire collection. To add one item without losing existing entries, first call GET /v1/profile, append to the returned array, then send the full updated array back. Omit the field to leave the collection unchanged; pass [] to clear it. Hard cap of 100 items per collection (50 for jobTitles).
​
summaries
array (max 100)
Professional summary versions: { title?: string, content: string }[]
​
projects
array (max 100)
Projects: { name, description, organisation?, startDate?, endDate?, isCurrent?, url? }[]
​
certificates
array (max 100)
Certificates: { name, issuer, description?, issueDate?, expiryDate?, credentialId?, verificationUrl? }[]
​
awards
array (max 100)
Awards: { name, organisation?, description?, date? }[]
​
publications
array (max 100)
Publications: { name, publisher?, date?, url?, description? }[]
​
interests
array (max 100)
Interests: { name, description? }[]
​
jobTitles
array (max 50)
Career-identity job titles: { title: string }[]

​
Example

curl -X PATCH "https://api.mokaru.ai/v1/profile" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "jobTitle": "Senior Software Engineer",
    "linkedIn": "jane-smith",
    "employer": "Acme Corp"
  }'

​
Response

​
success
boolean
Whether the profile was updated
{
  "success": true
}
LinkedIn usernames are automatically converted to full URLs. For example, "jane-smith" becomes "https://linkedin.com/in/jane-smith". Website and portfolio URLs have https:// prepended if no protocol is specified.