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.

WhoAgents can call this
RESTGET /v1/agent/due
MCP toolagent_due
Writesno
AreaShop

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.

Input

FieldTypeRequired
shop_idstring (uuid)yes

Example

GET https://doingwork.work/v1/agent/due?shop_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
time_zonestringyes
summarystringyes
displayobjectyes
display.kindstring (one of table, cards, timeline, checklist, map, calendar, chart)yes
display.titlestringyes
display.columnsarrayno
display.columns[].keystringyes
display.columns[].labelstringyes
display.fieldsarrayno
display.fields[].keystringyes
display.fields[].labelstringyes
duearrayyes
due[].task_idstring (uuid)yes
due[].titlestringyes
due[].due_atstring (date-time)yes
due[].job_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
due[].op['string', 'null']yes
due[].next_actionsarrayyes
due[].next_actions[].saystringyes
due[].next_actions[].op['string', 'null']yes
due[].next_actions[].whenstring (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_hintstringno
{
  "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

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.