jobs.list
Jobs of a shop you belong to, newest first. A field worker sees only jobs with a visit they are assigned to. A lead also sees jobs their crew is on. Another shop is refused, including a shop token pointed at a different shop. Optional status filter. Shop roles are owner, office, lead and field.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/jobs |
| MCP tool | jobs_list |
| Writes | no |
| Area | Jobs (unlimited) |
When to use it
Answer what's going on: open jobs, jobs waiting on payment, recent work.
What to tell the owner
Here are your jobs, newest first.
| Field | Type | Required |
|---|
shop_id | string | yes |
status | string | no |
limit | integer | no |
Example
GET https://doingwork.work/v1/jobs?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 |
jobs | array | yes |
jobs[].job_id | string (uuid) | yes |
jobs[].status | string (one of open, quoted, scheduled, in_progress, done, cancelled) | yes |
jobs[].kind | string | yes |
jobs[].summary | ['string', 'null'] | yes |
jobs[].occurred_at | string (date-time) | yes |
jobs[].home_id | string (uuid) | yes |
jobs[].address_line1 | string | yes |
jobs[].locality | string | yes |
jobs[].customer_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
{
"time_zone": "...",
"summary": "...",
"display": {
"kind": "table",
"title": "..."
},
"jobs": [
{
"job_id": "00000000-0000-4000-8000-000000000000",
"status": "open",
"kind": "...",
"summary": "...",
"occurred_at": "...",
"home_id": "00000000-0000-4000-8000-000000000000",
"address_line1": "...",
"locality": "Coeur d'Alene",
"customer_id": "00000000-0000-4000-8000-000000000000"
}
]
}
Errors
| Code | Status | What to do |
|---|
forbidden | 403 | This worker's role can't do this, or it needs a person's own sign-in rather than an agent token. Tell the person who can. |
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |