Skip to main content
PATCH
/
v1
/
skills
/
{id}
Update Skill
curl --request PATCH \
  --url https://api.mokaru.ai/v1/skills/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "category": {},
  "level": {}
}
'
{
  "success": true,
  "id": "<string>"
}

​
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.
Scope required: skills:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/skills/{id}

​
Body Parameters

All fields are optional, but at least one must be provided.
​
name
string
Skill name (max 100 characters)
​
category
string | null
Skill category (max 100 characters, null to clear)
​
level
string | null
Proficiency level (beginner, intermediate, advanced, expert, null to clear)

​
Example

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

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