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.

WhoAgents can call this
RESTGET /v1/tasks
MCP tooltasks_list
Writesno
AreaShop

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.

Input

FieldTypeRequired
shop_idstring (uuid)yes
assignee_idstring (uuid)no
job_idstring (uuid)no
statusstring (one of open, done, cancelled, all)no
duestring (one of overdue, today, all)no
for_agentbooleanno
limitintegerno

Example

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

Output

FieldTypeAlways there
tasksarrayyes
tasks[].task_idstring (uuid)yes
tasks[].shop_idstring (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[].titlestringyes
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[].statusstringyes
tasks[].overduebooleanyes
tasks[].created_bystring (uuid)yes
tasks[].created_atstring (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_agentbooleanyes
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

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