agent.checkup

A read-only look across the shop: stale quotes, overdue or failed invoices, tomorrow's visits that are not ready, recap drafts, unanswered customer requests, the one setup step still missing, jobs under the margin floor, double-booked workers, and maintenance that is due. Ranked, best first. Snoozed items are left out. Each item has next_actions. Nothing is sent.

WhoAgents can call this
RESTGET /v1/agent/checkup
MCP toolagent_checkup
Writesno
AreaShop

When to use it

A read-only look across the shop: stale quotes, overdue or failed invoices, tomorrow's visits that are not ready, recap drafts, unanswered customer requests, the one setup step still missing, jobs under the margin floor, double-booked workers, and maintenance that is due. Ranked, best first.

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/checkup?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
itemsarrayyes
items[].keystringyes
items[].rankintegeryes
items[].topicstringyes
items[].summarystringyes
items[].next_actionsarrayyes
items[].next_actions[].saystringyes
items[].next_actions[].op['string', 'null']yes
items[].next_actions[].whenstring (one of now, later, check, tell_human)yes
items[].next_actions[].due_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']no
items[].next_actions[].args_hintstringno
{
  "time_zone": "...",
  "summary": "...",
  "display": {
    "kind": "table",
    "title": "..."
  },
  "items": [
    {
      "key": "...",
      "rank": 1,
      "topic": "...",
      "summary": "...",
      "next_actions": [
        {
          "say": "...",
          "op": "...",
          "when": "now"
        }
      ]
    }
  ]
}

Errors

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