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

Lead rules (requests.setLeadSettings, owner or office) decide what happens to a new request. With auto_reply on, Doing Work sends one first reply within a minute: a text only where the customer already agreed to texts or texted the shop, and the shop's own number is approved for business texting; otherwise an email; otherwise nothing.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

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
`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": [
    {
      "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": "..."
    }
  ]
}

Errors

Code	Status	What to do
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.