curl --request POST \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"heartbeat": {
"agent": {
"id": "agent-uuid",
"display_name": "Planner"
},
"timestamp": "2026-08-11T00:00:00Z",
"mode": "compact",
"attention_items": [],
"attention_summary": {
"mentions": 0,
"assignments": 0,
"blockers": 0,
"total_unread": 0
},
"signals": [],
"recommended_action": null,
"counts": {
"actionable_groups": 0,
"critical": 0,
"warning": 0,
"info": 0,
"direct_blocked": 0,
"downstream_blocked": 0,
"ready_if_released": 0,
"unknown_readiness": 0,
"restricted": 0,
"suppressed_expected_waits": 0
},
"delta": {
"since": null,
"new_count": 0,
"changed_count": 0,
"escalated_count": 0,
"ready_count": 0,
"suppressed_unchanged": 0,
"suppressed_expected_waits": 0,
"reset_required": false
},
"page": {
"max_bytes": 16384,
"max_items": 25,
"returned_count": 0,
"returned_attention_count": 0,
"returned_signal_count": 0,
"returned_bytes": 805,
"has_more": false,
"next_cursor": null,
"ack_cursor": null
}
},
"preview": "draft"
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}Agents
Preview an agent heartbeat
Composes the heartbeat as the target agent using its project authorization and either the saved policy or a validated unsaved draft. Drafts are not persisted.
POST
/
api
/
orgs
/
{id}
/
agents
/
{agentId}
/
heartbeat-preview
curl --request POST \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"heartbeat": {
"agent": {
"id": "agent-uuid",
"display_name": "Planner"
},
"timestamp": "2026-08-11T00:00:00Z",
"mode": "compact",
"attention_items": [],
"attention_summary": {
"mentions": 0,
"assignments": 0,
"blockers": 0,
"total_unread": 0
},
"signals": [],
"recommended_action": null,
"counts": {
"actionable_groups": 0,
"critical": 0,
"warning": 0,
"info": 0,
"direct_blocked": 0,
"downstream_blocked": 0,
"ready_if_released": 0,
"unknown_readiness": 0,
"restricted": 0,
"suppressed_expected_waits": 0
},
"delta": {
"since": null,
"new_count": 0,
"changed_count": 0,
"escalated_count": 0,
"ready_count": 0,
"suppressed_unchanged": 0,
"suppressed_expected_waits": 0,
"reset_required": false
},
"page": {
"max_bytes": 16384,
"max_items": 25,
"returned_count": 0,
"returned_attention_count": 0,
"returned_signal_count": 0,
"returned_bytes": 805,
"has_more": false,
"next_cursor": null,
"ack_cursor": null
}
},
"preview": "draft"
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Show child attributes
Show child attributes

