Skip to main content
POST
Publish a revision to an owned Library

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Headers

Idempotency-Key
string
required

UUIDv7 key. The same key and body replay the accepted result; a changed body under the same key conflicts.

If-Match
string
required

Current strong tag from the resource's GET. A stale tag returns 412 with the current etag; an absent one returns 428.

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

library_id
string
required

Opaque Library identifier: a platform slug or an owned UUIDv7.

Body

application/json

Explicitly append a chat candidate to the selected owned entry.

draft_candidate_id
string
required

Current creator-private idle candidate UUIDv7.

Response

Explicit immutable revision

Publication receipt retains the original accepted revision on retry.

etag
string
required

Current Library strong tag.

head_revision_id
string
required

Current head UUIDv7.

library_id
string
required

Entry UUIDv7.

revision_id
string
required

Accepted immutable revision UUIDv7.