Update one agent skill
Change selected fields on one skill while preserving its id, type, and every other skill. Supply expectedVersion to reject stale writes.
Required API key scope: agents:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Path Parameters
Agent id.
1Stable skill id returned by the skills API.
1Body
Human-readable name for the skill. Longer input is truncated to 120 characters and saved, not rejected. Whitespace is trimmed first, so a whitespace-only name is rejected as empty.
1 - 120\SPlain-English trigger: when the agent should reach for this. Longer input is truncated to 300 characters and saved, not rejected.
300Whether the skill is active on the agent. A disabled skill is kept but its tool is not installed.
1 - 120001 - 40004001 - 401 - 1500200x >= 0Response
Skill updated.
x >= 0A plain-English playbook that teaches the agent when and how to handle a use case.
- Custom instruction skill
- Service area check
- Live transfer
- Add a tag
- Check a tag
- Appointment booking
Background synchronization work that did not finish. The skill change was still saved.
