agent.due
Follow-ups the agent scheduled for itself that are due now (tasks.create with for_agent). Each row has the words and the op to call. Read only. A field worker sees the ones they made; the owner and office see the shop's.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/agent/due |
| MCP tool | agent_due |
| Writes | no |
| Area | Shop |
When to use it
Follow-ups the agent scheduled for itself that are due now (tasks.create with for_agent). Each row has the words and the op to call.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
shop_id | string (uuid) | yes |
Example
GET https://doingwork.work/v1/agent/due?shop_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
time_zone | string | yes |
summary | string | yes |
display | object | yes |
display.kind | string (one of table, cards, timeline, checklist, map, calendar, chart) | yes |
display.title | string | yes |
display.columns | array | no |
display.columns[].key | string | yes |
display.columns[].label | string | yes |
display.fields | array | no |
display.fields[].key | string | yes |
display.fields[].label | string | yes |
due | array | yes |
due[].task_id | string (uuid) | yes |
due[].title | string | yes |
due[].due_at | string (date-time) | yes |
due[].job_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
due[].op | ['string', 'null'] | yes |
due[].next_actions | array | yes |
due[].next_actions[].say | string | yes |
due[].next_actions[].op | ['string', 'null'] | yes |
due[].next_actions[].when | string (one of now, later, check, tell_human) | yes |
due[].next_actions[].due_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | no |
due[].next_actions[].args_hint | string | no |
{
"time_zone": "...",
"summary": "...",
"display": {
"kind": "table",
"title": "..."
},
"due": [
{
"task_id": "00000000-0000-4000-8000-000000000000",
"title": "...",
"due_at": "...",
"job_id": "00000000-0000-4000-8000-000000000000",
"op": "...",
"next_actions": [
{
"say": "...",
"op": "...",
"when": "now"
}
]
}
]
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |