Skip to navigation
AgentsSkills

Skills · Edit a skill

View as Markdown

Partial update of a skill.

Editing an entry whose origin is builtin does not change Simplified’s copy — it creates a workspace override that shadows it, and only when the agent has extra.allow_skill_override. Without that flag this returns 403, which is the expected answer rather than a fault.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

agent_idstringRequired

Agent UUID or slug — both are accepted. From agents_listAgents.

doc_idstringRequired

Request

This endpoint expects an object.
titlestringOptional
Section heading used when the skill is injected.
slugstringOptional

Stable identifier. Generated from the title when omitted. Reusing a built-in skill's slug shadows it, which requires extra.allow_skill_override on the agent.

content_textstringOptional
The skill itself, as prose the model reads. This is the field that changes behaviour.
doc_typestringOptional

Freeform label. Conventional values: skill, rule, knowledge, template, reference, custom.

injection_modeenumOptional

system_prompt folds the text into the prompt every run. context_only keeps it retrievable without spending prompt budget.

Allowed values:
is_enabledbooleanOptional
Attached but inert when false.
orderintegerOptional
Injection order. Appended last when omitted.

Response

The updated skill.

Errors

403
Forbidden Error