Skip to main content
POST
Stage a private chat candidate in the platform 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

Required UUIDv7 replay key

Body

application/json

Stage an authorized creator-owned current candidate, initially hidden.

draft_candidate_id
string
required

Exact current candidate, resolved under creator and workspace authority.

label
string
required

Human display label; the stable slug comes from validated setup.

workspace_id
string
required

Workspace containing the authenticated person's private draft.

Response

Native revision staged; explicit publication is separate

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.