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

# Update Experience

> Update a work experience

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

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

## Request

```bash theme={null}
PATCH /v1/experiences/{id}
```

### Path Parameters

<ParamField path="id" type="string" required>
  The experience's unique ID
</ParamField>

### Body Parameters

All fields are optional, but at least one must be provided.

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

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

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

<ParamField body="startDate" type="string">
  ISO 8601 datetime (nullable)
</ParamField>

<ParamField body="endDate" type="string">
  ISO 8601 datetime (nullable)
</ParamField>

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

<ParamField body="description" type="string">
  Role description (nullable)
</ParamField>

<ParamField body="responsibilities" type="string[]">
  List of responsibilities (nullable)
</ParamField>

<ParamField body="achievements" type="string[]">
  List of achievements (nullable)
</ParamField>

### Query Parameters

<ParamField query="cvId" type="string">
  Target a specific resume by its id (from `list-resumes`). Omit to use your base/default resume; the resume must be self-contained.
</ParamField>

### Example

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

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

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