Skip to main content
PUT
Replace 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

Body

application/json
sections
object
required
signal_categories
object
required
project_ids
string<uuid>[]
required
initiative_ids
string<uuid>[]
required
columns
object[]
required
attention_categories
object

Optional complete category record. Omission means all enabled. sections.attention is the master. Task selection is independent; explicit null is invalid.

task_filters
object

Response

Saved 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.