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. Quotes and jobs imported as history are left out, signed or declined, so old work is not billed or followed up. Ranked, best first. Snoozed items are left out. Each item has next_actions. Nothing is sent.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/agent/checkup |
| MCP tool | agent_checkup |
| Writes | no |
| Area | Shop |
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. Quotes and jobs imported as history are left out, signed or declined, so old work is not billed or followed up.
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/checkup?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 |
items | array | yes |
items[].key | string | yes |
items[].rank | integer | yes |
items[].topic | string | yes |
items[].summary | string | yes |
items[].next_actions | array | yes |
items[].next_actions[].say | string | yes |
items[].next_actions[].op | ['string', 'null'] | yes |
items[].next_actions[].when | string (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_hint | string | no |
{
"time_zone": "...",
"summary": "...",
"display": {
"kind": "table",
"title": "..."
},
"items": [
{
"key": "...",
"rank": 1,
"topic": "...",
"summary": "...",
"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. |