Skip to main content
POST
Publish a chat candidate to 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.

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

Body

application/json

Explicitly publish a creator-owned chat candidate as a new reusable entry.

draft_candidate_id
string
required

Current creator-private idle candidate UUIDv7.

label
string
required

Display label, 1..100 characters.

Response

Explicit publication

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.