Skip to main content
POST
Publish a chat candidate to Plugin

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

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

Workspace identifier (version 7 universally unique identifier, or UUID).

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 Plugin ETag for conditional updates.

head_revision_id
string
required

Current head UUIDv7.

plugin_id
string
required

Entry UUIDv7.

revision_id
string
required

Accepted immutable revision UUIDv7.