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

​
Overview

The Create Experience endpoint lets you add a new work experience to your Mokaru account. Common use cases:
  • AI agent profile building - automatically add work experiences extracted from a LinkedIn profile or resume.
  • Career tracking - log a new position when you start a new role.
  • Bulk import - add work experiences from a spreadsheet or external system.
Scope required: experiences:write | Rate limit: 20 requests/min

​
Request

POST /v1/experiences

​
Body Parameters

​
jobTitle
string
required
Job title (max 200 characters)
​
company
string
required
Company name (max 200 characters)
​
location
string
Work location (max 200 characters)
​
startDate
string
ISO 8601 date string (e.g. “2022-07-01”)
​
endDate
string
ISO 8601 date string (null or omit for current position)
​
isCurrent
boolean
Whether this is the current position (default: false)
​
description
string
Role description (max 5000 characters)
​
responsibilities
array
List of responsibilities (array of strings)
​
achievements
array
List of achievements (array of strings)

​
Example

curl -X POST "https://api.mokaru.ai/v1/experiences" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": "Senior Software Engineer",
    "company": "Acme Corp",
    "location": "San Francisco, CA",
    "startDate": "2022-07-01",
    "isCurrent": true,
    "description": "Building and maintaining the core platform",
    "responsibilities": ["Led frontend architecture"],
    "achievements": ["Reduced bundle size by 40%"]
  }'

​
Response

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