> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Experience

> Create a new work experience

## 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.

<Note>
  **Scope required:** `experiences:write` | **Rate limit:** 20 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/experiences
```

### Body Parameters

<ParamField body="jobTitle" type="string" required>
  Job title (max 200 characters)
</ParamField>

<ParamField body="company" type="string" required>
  Company name (max 200 characters)
</ParamField>

<ParamField body="location" type="string">
  Work location (max 200 characters)
</ParamField>

<ParamField body="startDate" type="string">
  ISO 8601 date string (e.g. "2022-07-01")
</ParamField>

<ParamField body="endDate" type="string">
  ISO 8601 date string (null or omit for current position)
</ParamField>

<ParamField body="isCurrent" type="boolean">
  Whether this is the current position (default: false)
</ParamField>

<ParamField body="description" type="string">
  Role description (max 5000 characters)
</ParamField>

<ParamField body="responsibilities" type="array">
  List of responsibilities (array of strings)
</ParamField>

<ParamField body="achievements" type="array">
  List of achievements (array of strings)
</ParamField>

### Example

```bash theme={null}
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

<ResponseField name="success" type="boolean">Whether the experience was created</ResponseField>
<ResponseField name="id" type="string">The new experience's unique ID</ResponseField>

```json theme={null}
{
  "success": true,
  "id": "clx1234..."
}
```