Skip to Content
Skilder
REST APISkills

Discard a skill’s open draft

In beta. This endpoint can still change in ways that break your integration. See the REST API overview.
DELETE
/skills/{skillId}/draft

Discards the caller’s open draft; the published state is never touched, and the discarded edits cannot be recovered. Requires the Contributor or Admin role; a key needs write:skills. This closes the loop PATCH opens: an auto-opened draft that will not be published is released here instead of holding the author lock forever. Errors: 409 with reason: NO_OPEN_DRAFT when nothing is open to discard, 409 with reason: DRAFT_LOCKED when another user holds the draft (a draft is author-private; only its holder may discard it).

Authorization

apiKey
headerAuthorizationBearer <token>

Workspace API key (SKA_...).

Path Parameters

skillId*string

Skill id

Length1 <= length

Response Body

Draft discarded; the published state is unchanged

Example Request
curl -X DELETE 'https://app.skilder.ai/api/v1/skills/0x1a2b/draft'
Example Response
Empty