Skip to main content
POST
Publish

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string
required

Body

application/json
version_title
string

Optional label shown in the version history.

Maximum string length: 120
version_description
string

Optional longer note for audit and rollback context.

Maximum string length: 2000
expected_config_hash
string

Publish only while the draft has this config_hash. Otherwise 409 with reason draft_changed and nothing is written.

Maximum string length: 128
config
PublicAgentConfigPatchPayload · object

Draft changes to apply before publishing, same shape as Update Draft Config. The write and the publish succeed or fail together.

Response

Request fulfilled, document follows

version_number
integer
required
config_hash
string
required
published_at
string<date-time>
required
config
PublicAgentConfigEntity · object
required

The immutable configuration snapshot this version pinned at publish time.

created
boolean
required

Whether this call created a new version. False when the draft already matched the live version, which is returned unchanged.

version_title
string | null
version_description
string | null