Skip to main content
GET
Poll an agent publish job
Last reviewed 2026-11-09 Requires agent:publish. Store the response ETag, send it as If-None-Match on the next poll, and honor Retry-After. An unchanged job returns 304 Not Modified. A failed job does not change production. requestedRevision identifies the agent revision selected for this publish job.

Authorizations

Authorization
string
header
required

Hobbes API key with the hb_live_ prefix.

Headers

If-None-Match
string | null

Path Parameters

job_id
string<uuid>
required

Asynchronous job UUID.

Query Parameters

role_id
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