Skip to main content
GET
Read an agent heartbeat policy

Authorizations

sb-<project-ref>-auth-token
string
cookie
required

Authenticated Supabase web session for a human Atoll user. The cookie name includes the deployment's Supabase project reference and may be chunked.

Path Parameters

id
string
required
agentId
string
required

Response

Heartbeat policy management response

agent
object
required
status
enum<string>
required
Available options:
default,
customized
is_default
boolean
required
saved_policy
object | null
required

Persisted policy. Stale focus IDs remain here so saved previews and real heartbeats fail closed until the sanitized editable policy is saved.

effective_policy
object
required

Sanitized editable form with stale selections removed.

selectable
object
required
stale_selections
object
required

Focus IDs retained by the saved runtime policy but removed from the editable effective policy.

default_source
enum<string>

Source of the inherited policy when status is default: the organization default or the built-in heartbeat.

Available options:
organization,
built_in
has_unavailable_selections
boolean

Opaque unavailable-selection flag; hidden identifiers are omitted for machine callers.