Apply Playbook suggestions
curl --request POST \
--url https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"changeIds": [
"<string>"
],
"expectedSectionsEtag": "<string>",
"expectedGenerationRevision": 1
}
'import requests
url = "https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply"
payload = {
"changeIds": ["<string>"],
"expectedSectionsEtag": "<string>",
"expectedGenerationRevision": 1
}
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({
changeIds: ['<string>'],
expectedSectionsEtag: '<string>',
expectedGenerationRevision: 1
})
};
fetch('https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "applied",
"sectionsEtag": "<string>",
"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"
}
},
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isDefault": true,
"name": "<string>",
"selection": "explicit"
},
"version": 123,
"noChange": false,
"stagingRevision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}Apply Hobbes Playbook suggestions
Apply selected stored suggestion payloads exactly as generated.
POST
/
api
/
v1
/
playbook
/
suggestions
/
{group_id}
/
apply
Apply Playbook suggestions
curl --request POST \
--url https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"changeIds": [
"<string>"
],
"expectedSectionsEtag": "<string>",
"expectedGenerationRevision": 1
}
'import requests
url = "https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply"
payload = {
"changeIds": ["<string>"],
"expectedSectionsEtag": "<string>",
"expectedGenerationRevision": 1
}
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({
changeIds: ['<string>'],
expectedSectionsEtag: '<string>',
expectedGenerationRevision: 1
})
};
fetch('https://api-us.hihobbes.com/api/v1/playbook/suggestions/{group_id}/apply', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "applied",
"sectionsEtag": "<string>",
"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"
}
},
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isDefault": true,
"name": "<string>",
"selection": "explicit"
},
"version": 123,
"noChange": false,
"stagingRevision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
}{
"detail": "<string>"
}{
"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
playbook:write.
Send the selected suggestion IDs and their generation revision. Set
expectedSectionsEtag to the current sectionsEtag. Use the preview endpoint
instead when the proposed wording needs to be edited before it is applied to
staging.
Related docs
- Review the protected workflow for previewing and applying agent changes. 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