Skip to main content
POST
Publish a revision to an owned 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.

If-Match
string
required

Current ETag from the resource's GET response. An outdated value returns 412 with the current etag; omitting it returns 428.

Path Parameters

workspace_id
string
required

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

plugin_id
string<uuid>
required

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

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 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.