Queue an agent publish
curl --request POST \
--url https://api-us.hihobbes.com/api/v1/agent/publish-jobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"operationKey": "<string>",
"confirmation": "publish_to_production"
}
'import requests
url = "https://api-us.hihobbes.com/api/v1/agent/publish-jobs"
payload = {
"operationKey": "<string>",
"confirmation": "publish_to_production"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({operationKey: '<string>', confirmation: 'publish_to_production'})
};
fetch('https://api-us.hihobbes.com/api/v1/agent/publish-jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "queued",
"requestedVersion": 123,
"links": {
"staging": {
"target": {
"lane": "staging",
"revisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revisionNumber": 123,
"revisionStatus": "<string>"
},
"url": "<string>",
"availabilityReason": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
},
"production": {
"target": {
"lane": "staging",
"revisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revisionNumber": 123,
"revisionStatus": "<string>"
},
"url": "<string>",
"availabilityReason": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isDefault": true,
"name": "<string>",
"selection": "explicit"
},
"errorCode": "<string>",
"errorMessage": "<string>",
"productionLink": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"requestedRevisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requestedRevision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}Queue a Hobbes agent publish
Run tests and publish the exact staged agent revision after confirmation.
POST
/
api
/
v1
/
agent
/
publish-jobs
Queue an agent publish
curl --request POST \
--url https://api-us.hihobbes.com/api/v1/agent/publish-jobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"operationKey": "<string>",
"confirmation": "publish_to_production"
}
'import requests
url = "https://api-us.hihobbes.com/api/v1/agent/publish-jobs"
payload = {
"operationKey": "<string>",
"confirmation": "publish_to_production"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({operationKey: '<string>', confirmation: 'publish_to_production'})
};
fetch('https://api-us.hihobbes.com/api/v1/agent/publish-jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "queued",
"requestedVersion": 123,
"links": {
"staging": {
"target": {
"lane": "staging",
"revisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revisionNumber": 123,
"revisionStatus": "<string>"
},
"url": "<string>",
"availabilityReason": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
},
"production": {
"target": {
"lane": "staging",
"revisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revisionNumber": 123,
"revisionStatus": "<string>"
},
"url": "<string>",
"availabilityReason": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isDefault": true,
"name": "<string>",
"selection": "explicit"
},
"errorCode": "<string>",
"errorMessage": "<string>",
"productionLink": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"requestedRevisionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requestedRevision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}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.
Related docs
- Review the protected workflow for testing and publishing agent versions. Playbook and agent API guide
- Review the supported endpoint contract. Hobbes API overview
- Confirm the required key permissions. Authentication and scopes
Authorizations
bearerapiKeyHeader
Body
application/json
Response
Successful Response