Skip to main content
POST
Queue an agent publish
Last reviewed 2026-11-09 Requires agent:publish. Read the staging lane’s revision.id from the Playbook and send it as revisionId, with a stable operationKey and confirmation: "publish_to_production" only after the user explicitly approves that exact version. Hobbes runs the existing conversation tests before changing production and returns 202 Accepted with a job to poll. Use revisionId for new integrations. The version field is deprecated.

Authorizations

Authorization
string
header
required

Hobbes API key with the hb_live_ prefix.

Query Parameters

role_id
string<uuid> | null

Body

application/json
operationKey
string
required
Required string length: 1 - 255
confirmation
string
required
Allowed value: "publish_to_production"
version
integer | null
deprecated
Required range: x >= 1
revisionId
string<uuid> | null

Response

Successful Response

jobId
string<uuid>
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed
requestedVersion
integer
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
role
SelectedRoleSummary · object
required
errorCode
string | null
errorMessage
string | null
completedAt
string<date-time> | null
requestedRevisionId
string<uuid> | null
requestedRevision
AgentRevisionRef · object | null