Skip to main content
PATCH
/
v1
/
experiences
/
{id}
Update Experience
curl --request PATCH \
  --url https://api.mokaru.ai/v1/experiences/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jobTitle": "<string>",
  "company": "<string>",
  "location": {},
  "startDate": {},
  "endDate": {},
  "isCurrent": true,
  "description": {},
  "responsibilities": {},
  "achievements": {}
}
'
{
  "success": true,
  "id": "<string>"
}

​
Overview

The Update Experience endpoint lets you modify an existing work experience’s details. Only include the fields you want to change. Pass null for optional fields to clear them.
Scope required: experiences:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/experiences/{id}

​
Body Parameters

All fields are optional, but at least one must be provided.
​
jobTitle
string
Job title (max 200 characters)
​
company
string
Company name (max 200 characters)
​
location
string | null
Work location (max 200 characters, null to clear)
​
startDate
string | null
ISO 8601 date string (null to clear)
​
endDate
string | null
ISO 8601 date string (null to clear)
​
isCurrent
boolean
Whether this is the current position
​
description
string | null
Role description (max 5000 characters, null to clear)
​
responsibilities
array | null
List of responsibilities (null to clear)
​
achievements
array | null
List of achievements (null to clear)

​
Example

curl -X PATCH "https://api.mokaru.ai/v1/experiences/clx1234" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "isCurrent": false,
    "endDate": "2026-03-15",
    "achievements": ["Reduced bundle size by 40%", "Shipped design system v2"]
  }'

​
Response

​
success
boolean
Whether the experience was updated
​
id
string
The experience’s ID
{
  "success": true,
  "id": "clx1234..."
}