Delete a skill
Cascade-deletes the skill with its related resources and version history. Irreversible. Owner-scoped: an admin may delete any skill, a contributor only their own; a key needs write:skills.
apiKeyAuthorizationBearer <token>Workspace API key (SKA_...).
skillId*stringSkill id
1 <= lengthDeleted
curl -X DELETE 'https://app.skilder.ai/api/v1/skills/0x1a2b'Update a skill (into its draft) PATCH
Requires the Contributor or Admin role; a key needs `write:skills`. Content edits land on the caller’s draft, which is opened automatically when none exists; the published state is untouched until an explicit publish. 409 when another user holds the open draft. `disabled` is operational, applied to the published state directly, and owner-scoped (the owner or an admin; a key needs `publish:skills`). `ownerId` transfers ownership (owner-scoped) as part of the draft.
Publish a skill’s draft POST
Promotes the skill’s currently open draft to the published state (the version agents run) — nothing else. It takes no edits: make them with `PATCH /skills/{skillId}` first, an ownership transfer included, and the publish carries them. Requires the owner-scoped `publish` ability (a workspace admin or the skill’s owner), which is also what lets the caller promote a draft authored by someone else without taking it over. The body is optional: empty publishes the open draft as-is. Errors: **409 with `reason: NO_OPEN_DRAFT`** when nothing is open to publish (edit it first with PATCH), **403** when the caller is not the skill’s owner or a workspace admin, or the key lacks `publish:skills`.

