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

> Update a skill

## Overview

The Update Skill endpoint lets you modify an existing skill's details. Only include the fields you want to change. Pass `null` for optional fields to clear them.

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

## Request

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

### Body Parameters

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

<ParamField body="name" type="string">
  Skill name (max 100 characters)
</ParamField>

<ParamField body="category" type="string | null">
  Skill category (max 100 characters, null to clear)
</ParamField>

<ParamField body="level" type="string | null">
  Proficiency level (beginner, intermediate, advanced, expert, null to clear)
</ParamField>

### Example

```bash theme={null}
curl -X PATCH "https://api.mokaru.ai/v1/skills/clx1234" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "level": "expert",
    "category": "Programming Languages"
  }'
```

## Response

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

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