RespondAttentionItemAPI mirrors erdo_respond_attention_item: answer a choice
curl --request POST \
--url https://api.erdo.ai/v1/attention/{itemID}/respond \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"answer": {},
"defects": [
{
"reason": "<string>",
"variant_key": "<string>"
}
],
"organization_slug": "<string>"
}
'import requests
url = "https://api.erdo.ai/v1/attention/{itemID}/respond"
payload = {
"action": "<string>",
"answer": {},
"defects": [
{
"reason": "<string>",
"variant_key": "<string>"
}
],
"organization_slug": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
answer: {},
defects: [{reason: '<string>', variant_key: '<string>'}],
organization_slug: '<string>'
})
};
fetch('https://api.erdo.ai/v1/attention/{itemID}/respond', 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://api.erdo.ai/v1/attention/{itemID}/respond",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'action' => '<string>',
'answer' => [
],
'defects' => [
[
'reason' => '<string>',
'variant_key' => '<string>'
]
],
'organization_slug' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.erdo.ai/v1/attention/{itemID}/respond"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.erdo.ai/v1/attention/{itemID}/respond")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/attention/{itemID}/respond")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"decision_slug": "<string>",
"item": {
"answer": {},
"answered_at": "2023-11-07T05:31:56Z",
"answered_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ask": "<string>",
"body_markdown": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"cycle_started_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "<string>",
"last_confirmed_at": "2023-11-07T05:31:56Z",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payload": "<unknown>",
"read_at": "2023-11-07T05:31:56Z",
"resolution_note": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"severity": "<string>",
"slug": "<string>",
"status": "<string>",
"subjects": [
{
"id": "<string>",
"kind": "<string>",
"label": "<string>"
}
],
"title": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workstream_slug": "<string>"
},
"report": {
"approval": {
"action_context": "<string>",
"action_display": "<string>",
"action_headline": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card_contract_version": "<string>",
"decided_at": "2023-11-07T05:31:56Z",
"items": [
{
"params": {},
"what": "<string>",
"why": "<string>"
}
],
"occurrence_count": 123,
"omitted_items": 123,
"status": "<string>",
"subject_display_name": "<string>"
},
"approval_unreadable": true,
"decision": {
"age_seconds": 123,
"agent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"alternatives_considered": "<string>",
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_name": "<string>",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"exit_condition": "<string>",
"has_pending_effects": true,
"lapsed": true,
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"review_by": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"decision_slug": "<string>",
"effects": [
{
"baseline_value": 123,
"baseline_window_days": -1,
"binding_kind": "<string>",
"confidence": 123,
"conflict_decision_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contract_version": "<string>",
"dataset_metric": "<string>",
"evaluator_id": "<string>",
"evaluator_version": "<string>",
"evidence_freshness_at": "2023-11-07T05:31:56Z",
"evidence_kind": "<string>",
"first_exposure_at": "2023-11-07T05:31:56Z",
"fully_effective_at": "2023-11-07T05:31:56Z",
"guardrails": [
{
"metric": "<string>",
"min_delta": 123,
"operator": "<string>",
"target_value": 123
}
],
"measurability": "<string>",
"measured_at": "2023-11-07T05:31:56Z",
"metric": "<string>",
"min_delta": 123,
"outcome": "<string>",
"outcome_label": "<string>",
"outcome_value": 123,
"outcome_window_days": -1,
"sample_size": -1,
"settled_at": "2023-11-07T05:31:56Z",
"source_observation_count": 123,
"status": "<string>",
"success_operator": "<string>",
"target_value": 123,
"unmeasurable_reason": "<string>",
"variant_key": "<string>"
}
],
"has_pending_action": true,
"proposed_answer": "<string>",
"related_items": [
{
"created_at": "2023-11-07T05:31:56Z",
"cycle_started_at": "2023-11-07T05:31:56Z",
"kind": "<string>",
"same_title": true,
"same_workstream": true,
"severity": "<string>",
"slug": "<string>",
"status": "<string>",
"title": "<string>"
}
],
"safe_default": "<unknown>",
"safe_default_approves": true,
"workstream_slug": "<string>",
"workstream_title": "<string>"
}
}{
"code": "not_found",
"details": {},
"message": "<string>"
}API Reference
RespondAttentionItemAPI mirrors erdo_respond_attention_item: answer a choice
or escalation, acknowledge (mark read), or dismiss. Answers route through the same service method the web feed uses, so a choice answer lands as human comparison observations (judge_slug human:<user_id>) in the calibration ledger, and any flagged-broken variants land as ‘defect’ observations.
POST
/
v1
/
attention
/
{itemID}
/
respond
RespondAttentionItemAPI mirrors erdo_respond_attention_item: answer a choice
curl --request POST \
--url https://api.erdo.ai/v1/attention/{itemID}/respond \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"answer": {},
"defects": [
{
"reason": "<string>",
"variant_key": "<string>"
}
],
"organization_slug": "<string>"
}
'import requests
url = "https://api.erdo.ai/v1/attention/{itemID}/respond"
payload = {
"action": "<string>",
"answer": {},
"defects": [
{
"reason": "<string>",
"variant_key": "<string>"
}
],
"organization_slug": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
answer: {},
defects: [{reason: '<string>', variant_key: '<string>'}],
organization_slug: '<string>'
})
};
fetch('https://api.erdo.ai/v1/attention/{itemID}/respond', 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://api.erdo.ai/v1/attention/{itemID}/respond",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'action' => '<string>',
'answer' => [
],
'defects' => [
[
'reason' => '<string>',
'variant_key' => '<string>'
]
],
'organization_slug' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.erdo.ai/v1/attention/{itemID}/respond"
payload := strings.NewReader("{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.erdo.ai/v1/attention/{itemID}/respond")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/attention/{itemID}/respond")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"action\": \"<string>\",\n \"answer\": {},\n \"defects\": [\n {\n \"reason\": \"<string>\",\n \"variant_key\": \"<string>\"\n }\n ],\n \"organization_slug\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"decision_slug": "<string>",
"item": {
"answer": {},
"answered_at": "2023-11-07T05:31:56Z",
"answered_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ask": "<string>",
"body_markdown": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"cycle_started_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "<string>",
"last_confirmed_at": "2023-11-07T05:31:56Z",
"organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payload": "<unknown>",
"read_at": "2023-11-07T05:31:56Z",
"resolution_note": "<string>",
"resolved_at": "2023-11-07T05:31:56Z",
"severity": "<string>",
"slug": "<string>",
"status": "<string>",
"subjects": [
{
"id": "<string>",
"kind": "<string>",
"label": "<string>"
}
],
"title": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workstream_slug": "<string>"
},
"report": {
"approval": {
"action_context": "<string>",
"action_display": "<string>",
"action_headline": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"card_contract_version": "<string>",
"decided_at": "2023-11-07T05:31:56Z",
"items": [
{
"params": {},
"what": "<string>",
"why": "<string>"
}
],
"occurrence_count": 123,
"omitted_items": 123,
"status": "<string>",
"subject_display_name": "<string>"
},
"approval_unreadable": true,
"decision": {
"age_seconds": 123,
"agent_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"alternatives_considered": "<string>",
"applicability": "<string>",
"approval_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"authorized_at": "2023-11-07T05:31:56Z",
"decided_by_name": "<string>",
"decided_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"decider_kind": "<string>",
"decider_rationale": "<string>",
"decision_class": "<string>",
"evidence_kind": "<string>",
"execution_status": "<string>",
"exit_condition": "<string>",
"has_pending_effects": true,
"lapsed": true,
"outcome_label": "<string>",
"outcome_status": "<string>",
"proposed_at": "2023-11-07T05:31:56Z",
"rejected_at": "2023-11-07T05:31:56Z",
"review_by": "2023-11-07T05:31:56Z",
"slug": "<string>",
"source": "<string>",
"status": "<string>",
"subject_kind": "<string>",
"subject_label": "<string>",
"superseded_by_decision_slug": "<string>",
"supersedes_decision_slug": "<string>",
"what": "<string>",
"why": "<string>",
"workstream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"decision_slug": "<string>",
"effects": [
{
"baseline_value": 123,
"baseline_window_days": -1,
"binding_kind": "<string>",
"confidence": 123,
"conflict_decision_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contract_version": "<string>",
"dataset_metric": "<string>",
"evaluator_id": "<string>",
"evaluator_version": "<string>",
"evidence_freshness_at": "2023-11-07T05:31:56Z",
"evidence_kind": "<string>",
"first_exposure_at": "2023-11-07T05:31:56Z",
"fully_effective_at": "2023-11-07T05:31:56Z",
"guardrails": [
{
"metric": "<string>",
"min_delta": 123,
"operator": "<string>",
"target_value": 123
}
],
"measurability": "<string>",
"measured_at": "2023-11-07T05:31:56Z",
"metric": "<string>",
"min_delta": 123,
"outcome": "<string>",
"outcome_label": "<string>",
"outcome_value": 123,
"outcome_window_days": -1,
"sample_size": -1,
"settled_at": "2023-11-07T05:31:56Z",
"source_observation_count": 123,
"status": "<string>",
"success_operator": "<string>",
"target_value": 123,
"unmeasurable_reason": "<string>",
"variant_key": "<string>"
}
],
"has_pending_action": true,
"proposed_answer": "<string>",
"related_items": [
{
"created_at": "2023-11-07T05:31:56Z",
"cycle_started_at": "2023-11-07T05:31:56Z",
"kind": "<string>",
"same_title": true,
"same_workstream": true,
"severity": "<string>",
"slug": "<string>",
"status": "<string>",
"title": "<string>"
}
],
"safe_default": "<unknown>",
"safe_default_approves": true,
"workstream_slug": "<string>",
"workstream_title": "<string>"
}
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Authorizations
An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).
Path Parameters
Body
application/json
Response
Success response
it has one: an escalation carrying a held engine action records its decision at creation, so the item page can link straight to the report — the human answering "disable this automation" can read what was decided, on whose authority and with what outcome. Empty for digests, choices and plain escalations with no decision behind them, which is most items.
It is also on Report, and it stays here because the answer/acknowledge/ dismiss endpoints return this same shape and carry no report: a caller that just answered an item should still be told what it decided.
surfaced in the Activity feed. See migrations/008_create_attention_item.
Show child attributes
Show child attributes
without opening a database: what Erdo read, what it proposes, what happens if nobody answers, and what the item is connected to.
It exists because the feed card is a headline. In September 2026 one organization raised 45 escalations and the platform expired 141 of the 181 raised that month unanswered — a correct diagnosis expires exactly as quietly as a wrong one when the reasoning behind it cannot be read.
Every field is a projection of something already stored. Nothing here is derived prose, and nothing is invented when a fact is missing: an item with no decision behind it carries no decision, which is the ordinary case.
Show child attributes
Show child attributes