Retrieve the Playbook
curl --request GET \
--url https://api-us.hihobbes.com/api/v1/playbook \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-us.hihobbes.com/api/v1/playbook"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-us.hihobbes.com/api/v1/playbook', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"staging": {
"version": 123,
"visibleSections": {},
"revision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
},
"production": {
"version": 123,
"visibleSections": {},
"revision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
},
"sectionCatalog": [
{
"key": "<string>",
"title": "<string>",
"kind": "structured",
"order": 123,
"description": "<string>",
"present": true,
"category": "<string>"
}
],
"sectionsEtag": "<string>",
"isLegacyStructure": true,
"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"
},
"policyOwnedSections": [
{
"approvalTool": "approve_browser_guardrails",
"instructionsTool": "propose_browser_guardrail_instructions",
"publication": "shared_policy_revision",
"readTool": "get_browser_guardrails",
"restrictionTool": "propose_browser_restriction",
"sectionKey": "browser_guardrails",
"title": "Browser guardrails"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>"
}Retrieve the Hobbes Playbook
Return structured staging and production Playbooks, versions, and agent links.
GET
/
api
/
v1
/
playbook
Retrieve the Playbook
curl --request GET \
--url https://api-us.hihobbes.com/api/v1/playbook \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-us.hihobbes.com/api/v1/playbook"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-us.hihobbes.com/api/v1/playbook', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"staging": {
"version": 123,
"visibleSections": {},
"revision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
},
"production": {
"version": 123,
"visibleSections": {},
"revision": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"status": "draft"
}
},
"sectionCatalog": [
{
"key": "<string>",
"title": "<string>",
"kind": "structured",
"order": 123,
"description": "<string>",
"present": true,
"category": "<string>"
}
],
"sectionsEtag": "<string>",
"isLegacyStructure": true,
"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"
},
"policyOwnedSections": [
{
"approvalTool": "approve_browser_guardrails",
"instructionsTool": "propose_browser_guardrail_instructions",
"publication": "shared_policy_revision",
"readTool": "get_browser_guardrails",
"restrictionTool": "propose_browser_restriction",
"sectionKey": "browser_guardrails",
"title": "Browser guardrails"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>"
}Last reviewed 2026-11-09
Requires
playbook:read.
Use sectionsEtag for concurrency-safe previews. The response includes the
section catalog, exact staging and production versions, and links for testing
each agent. Legacy Playbooks are returned as read-only.
Each lane includes its agent revision. Use revision.id to identify a revision
and revision.number as its displayed version. Request a publish using the
staging revision’s ID.
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
Response
Successful Response