tasks.list
Tasks you can see, filtered by worker, job, status (open by default; done, cancelled or all) and due (overdue, today in shop time, or all). Overdue first, then by due time. A field worker sees their own tasks, tasks they made and tasks on jobs they are booked on.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/tasks |
| MCP tool | tasks_list |
| Writes | no |
| Area | Shop |
When to use it
Tasks you can see, filtered by worker, job, status (open by default; done, cancelled or all) and due (overdue, today in shop time, or all). Overdue first, then by due time.
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 |
assignee_id | string (uuid) | no |
job_id | string (uuid) | no |
status | string (one of open, done, cancelled, all) | no |
due | string (one of overdue, today, all) | no |
for_agent | boolean | no |
limit | integer | no |
Example
GET https://doingwork.work/v1/tasks?shop_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
tasks | array | yes |
tasks[].task_id | string (uuid) | yes |
tasks[].shop_id | string (uuid) | yes |
tasks[].job_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
tasks[].job_summary | ['string', 'null'] | yes |
tasks[].note_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
tasks[].title | string | yes |
tasks[].assignee_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
tasks[].assignee_name | ['string', 'null'] | yes |
tasks[].due_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
tasks[].status | string | yes |
tasks[].overdue | boolean | yes |
tasks[].created_by | string (uuid) | yes |
tasks[].created_at | string (date-time) | yes |
tasks[].closed_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
tasks[].close_note | ['string', 'null'] | yes |
tasks[].chased_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
tasks[].for_agent | boolean | yes |
tasks[].followup_op | ['string', 'null'] | yes |
{
"tasks": [
{
"task_id": "00000000-0000-4000-8000-000000000000",
"shop_id": "00000000-0000-4000-8000-000000000000",
"job_id": "00000000-0000-4000-8000-000000000000",
"job_summary": "...",
"note_id": "00000000-0000-4000-8000-000000000000",
"title": "...",
"assignee_id": "00000000-0000-4000-8000-000000000000",
"assignee_name": "...",
"due_at": "...",
"status": "...",
"overdue": true,
"created_by": "00000000-0000-4000-8000-000000000000",
"created_at": "...",
"closed_at": "...",
"close_note": "...",
"chased_at": "...",
"for_agent": true,
"followup_op": "..."
}
]
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |