skill-drafts

Publish a draft as a new skill version

Compile the draft into ONE immutable version. The version is created exactly as the direct authoring routes create it: an owner or admin author's version is ready to enable immediately, and a version authored without that authority stays PROPOSED until an owner or admin approves it. Publishing does NOT enable the skill — enabling is a separate step with its own permission, so publishing from a draft is never a way around who may give a skill to the whole workspace.

A skill that has been published again by someone else since you started editing is refused until you review what changed (POST /skill-drafts/{id}/rebase).

post/v1/skill-drafts/{draft_id}/publish

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/skill-drafts/{draft_id}/publish
  • Auth: HTTP bearer

Path parameters

draft_idstring uuid required

Headers

X-Tenant-Idstring nullable

Response

Successful Response

skill_idstring uuid required
manifest_version_idstring uuid required
slugstring required
semverstring required
titlestring required
status_codestring required
createdboolean required

Changes

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