Update an AI skill
PATCH/ai-skills/:id
Partial update of one of the token person's skills — someone else's is read-only (403, details.reason: not_owner). files and member_ids replace the whole list. active: false hides the skill from the assistant. Requires scope finance/ai_skills with access level write.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Updated skill.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance/ai_skills scope or the write access level, the person lacks ai-skills.update, the skill is someone else's (details.reason: not_owner), the body opens it beyond private without the person's ai-skills.share (details.reason: missing_share_permission), or visibility is above what the workspace's AI settings allow (details.reason: above_max_visibility).
AI skill not found among the skills the token person can see in the workspace.
The person already has another skill with this slug (details.reason: slug_taken), or X-Idempotency-Key reuse with a different body.
Schema validation failure, or member_ids naming someone who cannot receive it (details.reason: member_not_eligible).
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.