Deactivate Skill

Server URLloading...

POST

/skills/{skill_id}/deactivate

Send

Path

Turn an active skill OFF: keep it (body, versions, outcomes) but stop your agents using it.

The non-destructive half of the on/off toggle. We move active -> draft (the compiled-but-not-live stage) and un-materialize from host skill dirs, so agents stop seeing it. Nothing is lost: turning it back on is the existing activate (draft -> active), instant and lossless. This is deliberately NOT archive (a removal end-state) and NOT a revert to a suggestion (that would discard the compiled bundle and its history). A toggle must be reversible; discarding is a separate, explicit gesture.

Scoped by id; the active set is global, so the materializer reconciles all hosts.

Path Parameters

Response Body

curl -X POST "https://example.com/skills/string/deactivate"

{}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}