Skills

Activate Skill Endpoint

Toggle the caller's activation of a skill (turn it on or off).

{"active": true} enables the skill for the authenticated caller (an idempotent upsert); {"active": false} disables it (an idempotent delete). The user is always the authenticated caller, never client-supplied.

Authorization is view-only: the caller must be able to view the skill (owned or shared into their scope). get_skill_metadata enforces that and yields the skill for the response — a caller who cannot view it gets the existing 404 skill_not_found path (no existence leak). A viewer may always toggle their own activation; the owner may disable their own skill.

post/v1/skills/{skill_id}/activate

Request

Path parameters

skill_idstring required

Request body

activeboolean required

Response

Successful Response

idstring required
object'skill'
namestring required
descriptionstring required
metadataobject
default_versioninteger required
latest_versioninteger required
created_atinteger required
is_activeboolean

Changes

No recorded changes to this operation across all 1 revision of this API.