curl --request POST \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-preview \
--header 'Content-Type: application/json' \
--cookie sb-%3Cproject-ref%3E-auth-token= \
--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
Existing human management rules or an explicit heartbeat.manage_self/heartbeat.manage_others grant. Other excludes self. Real enabled agent identities only; integrations/setup keys are excluded. Resource visibility is the current caller/target intersection. Project destinations separately require webhook.dispatch and both principals project access; organization destinations require webhook.organization_manage. Private/no-store responses. PUT is full replacement, preview persists nothing, test queues an empty labeled payload under the actual tester. Authority is rechecked before queue/retry; in-flight requests cannot be recalled.
POST
/
api
/
orgs
/
{id}
/
agents
/
{agentId}
/
heartbeat-preview
curl --request POST \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-preview \
--header 'Content-Type: application/json' \
--cookie sb-%3Cproject-ref%3E-auth-token= \
--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
humanSessionAuthbearerAuth

