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.

WhoAgents can call this
RESTGET /v1/jobs
MCP tooljobs_list
Writesno
AreaJobs (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.

Input

FieldTypeRequired
shop_idstringyes
statusstringno
limitintegerno

Example

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

Output

FieldTypeAlways there
time_zonestringyes
summarystringyes
displayobjectyes
display.kindstring (one of table, cards, timeline, checklist, map, calendar, chart)yes
display.titlestringyes
display.columnsarrayno
display.columns[].keystringyes
display.columns[].labelstringyes
display.fieldsarrayno
display.fields[].keystringyes
display.fields[].labelstringyes
jobsarrayyes
jobs[].job_idstring (uuid)yes
jobs[].statusstring (one of open, quoted, scheduled, in_progress, done, cancelled)yes
jobs[].kindstringyes
jobs[].summary['string', 'null']yes
jobs[].occurred_atstring (date-time)yes
jobs[].home_idstring (uuid)yes
jobs[].address_line1stringyes
jobs[].localitystringyes
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

CodeStatusWhat to do
forbidden403This 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_limitedCan happen on any call. See errors.