Reset an agent heartbeat policy
curl --request DELETE \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy \
--cookie sb-%3Cproject-ref%3E-auth-token=import requests
url = "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy"
headers = {"cookie": "sb-%3Cproject-ref%3E-auth-token="}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {cookie: 'sb-%3Cproject-ref%3E-auth-token='}};
fetch('https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_COOKIE => "sb-%3Cproject-ref%3E-auth-token=",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("cookie", "sb-%3Cproject-ref%3E-auth-token=")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy")
.header("cookie", "sb-%3Cproject-ref%3E-auth-token=")
.asString();require 'uri'
require 'net/http'
url = URI("https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["cookie"] = 'sb-%3Cproject-ref%3E-auth-token='
response = http.request(request)
puts response.read_body{
"agent": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"avatar_url": "<string>"
},
"status": "default",
"is_default": true,
"saved_policy": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_by_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"sections": "<unknown>",
"signal_categories": "<unknown>",
"project_ids": "<unknown>",
"initiative_ids": "<unknown>",
"columns": "<unknown>",
"attention_categories": {
"assignment": true,
"mention": true,
"blocker": true,
"execution": true
},
"task_filters": {
"due_within_days": 4503599627370495,
"respect_agent_not_before": true,
"assignment_scope": "assigned",
"require_unblocked": true,
"recent_attempt_cooldown_hours": 4503599627370495.5
}
},
"effective_policy": {
"sections": {
"goals": true,
"standalone_kpis": true,
"standalone_initiatives": true,
"assigned_issues": true,
"project_context": true,
"signals": true,
"attention": true
},
"signal_categories": {
"task": true,
"initiative": true,
"kpi": true,
"project": true
},
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"initiative_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"columns": [
{
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"column_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"attention_categories": {
"assignment": true,
"mention": true,
"blocker": true,
"execution": true
},
"task_filters": {
"due_within_days": 4503599627370495,
"respect_agent_not_before": true,
"assignment_scope": "assigned",
"require_unblocked": true,
"recent_attempt_cooldown_hours": 4503599627370495.5
}
},
"selectable": {
"projects": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"initiatives": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
],
"columns": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"label": "<string>",
"position": 123
}
]
},
"stale_selections": {
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"initiative_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"columns": "<unknown>"
},
"default_source": "organization",
"has_unavailable_selections": true
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}Agents
Reset an agent heartbeat policy
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.
DELETE
/
api
/
orgs
/
{id}
/
agents
/
{agentId}
/
heartbeat-policy
Reset an agent heartbeat policy
curl --request DELETE \
--url https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy \
--cookie sb-%3Cproject-ref%3E-auth-token=import requests
url = "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy"
headers = {"cookie": "sb-%3Cproject-ref%3E-auth-token="}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {cookie: 'sb-%3Cproject-ref%3E-auth-token='}};
fetch('https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_COOKIE => "sb-%3Cproject-ref%3E-auth-token=",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("cookie", "sb-%3Cproject-ref%3E-auth-token=")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy")
.header("cookie", "sb-%3Cproject-ref%3E-auth-token=")
.asString();require 'uri'
require 'net/http'
url = URI("https://atollhq.com/api/orgs/{id}/agents/{agentId}/heartbeat-policy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["cookie"] = 'sb-%3Cproject-ref%3E-auth-token='
response = http.request(request)
puts response.read_body{
"agent": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"avatar_url": "<string>"
},
"status": "default",
"is_default": true,
"saved_policy": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"updated_by_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"sections": "<unknown>",
"signal_categories": "<unknown>",
"project_ids": "<unknown>",
"initiative_ids": "<unknown>",
"columns": "<unknown>",
"attention_categories": {
"assignment": true,
"mention": true,
"blocker": true,
"execution": true
},
"task_filters": {
"due_within_days": 4503599627370495,
"respect_agent_not_before": true,
"assignment_scope": "assigned",
"require_unblocked": true,
"recent_attempt_cooldown_hours": 4503599627370495.5
}
},
"effective_policy": {
"sections": {
"goals": true,
"standalone_kpis": true,
"standalone_initiatives": true,
"assigned_issues": true,
"project_context": true,
"signals": true,
"attention": true
},
"signal_categories": {
"task": true,
"initiative": true,
"kpi": true,
"project": true
},
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"initiative_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"columns": [
{
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"column_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"attention_categories": {
"assignment": true,
"mention": true,
"blocker": true,
"execution": true
},
"task_filters": {
"due_within_days": 4503599627370495,
"respect_agent_not_before": true,
"assignment_scope": "assigned",
"require_unblocked": true,
"recent_attempt_cooldown_hours": 4503599627370495.5
}
},
"selectable": {
"projects": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"initiatives": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
],
"columns": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"label": "<string>",
"position": 123
}
]
},
"stale_selections": {
"project_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"initiative_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"columns": "<unknown>"
},
"default_source": "organization",
"has_unavailable_selections": true
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Unauthorized",
"code": "unauthorized"
}Authorizations
humanSessionAuthbearerAuth
Response
Default heartbeat policy management response

