search.global

Search one shop for customers (name, email, phone), properties (address), equipment (kind, make, model, serial, notes), jobs (summary), requests (title), notes (words, on any record) and photos and videos (what the agent said they show, readable text such as serial numbers, video transcripts). Case-insensitive; you see only what your role can read.

WhoAgents can call this
RESTGET /v1/search
MCP toolsearch_global
Writesno
AreaImports, custom fields, tags and search

When to use it

Search one shop for customers (name, email, phone), properties (address), equipment (kind, make, model, serial, notes), jobs (summary), requests (title), notes (words, on any record) and photos and videos (what the agent said they show, readable text such as serial numbers, video transcripts). Case-insensitive; you see only what your role can read.

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
qstringyes
limitintegerno

Example

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

Output

FieldTypeAlways there
customersarrayyes
customers[].customer_idstring (uuid)yes
customers[].namestringyes
customers[].email['string', 'null']yes
customers[].phone['string', 'null']yes
propertiesarrayyes
properties[].property_idstring (uuid)yes
properties[].customer_idstring (uuid)yes
properties[].label['string', 'null']yes
properties[].address_line1stringyes
equipmentarrayyes
equipment[].equipment_idstring (uuid)yes
equipment[].property_idstring (uuid)yes
equipment[].customer_idstring (uuid)yes
equipment[].kindstringyes
equipment[].make['string', 'null']yes
equipment[].model['string', 'null']yes
equipment[].serial['string', 'null']yes
equipment[].notes['string', 'null']yes
jobsarrayyes
jobs[].job_idstring (uuid)yes
jobs[].customer_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
jobs[].statusstringyes
jobs[].summary['string', 'null']yes
requestsarrayyes
requests[].request_idstring (uuid)yes
requests[].customer_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
requests[].titlestringyes
notesarrayyes
notes[].note_idstring (uuid)yes
notes[].target_kindstringyes
notes[].target_idstring (uuid)yes
notes[].job_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
notes[].audiencestringyes
notes[].snippetstringyes
notes[].created_atstring (date-time)yes
mediaarrayyes
media[].media_idstring (uuid)yes
media[].job_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
media[].kindstringyes
media[].stagestringyes
media[].summarystringyes
{
  "customers": [
    {
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "name": "Ruiz Plumbing",
      "email": "owner@example.com",
      "phone": "..."
    }
  ],
  "properties": [
    {
      "property_id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "label": "...",
      "address_line1": "..."
    }
  ],
  "equipment": [
    {
      "equipment_id": "00000000-0000-4000-8000-000000000000",
      "property_id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "kind": "...",
      "make": "...",
      "model": "...",
      "serial": "...",
      "notes": "..."
    }
  ],
  "jobs": [
    {
      "job_id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "status": "...",
      "summary": "..."
    }
  ],
  "requests": [
    {
      "request_id": "00000000-0000-4000-8000-000000000000",
      "customer_id": "00000000-0000-4000-8000-000000000000",
      "title": "..."
    }
  ],
  "notes": [
    {
      "note_id": "00000000-0000-4000-8000-000000000000",
      "target_kind": "...",
      "target_id": "00000000-0000-4000-8000-000000000000",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "audience": "...",
      "snippet": "...",
      "created_at": "..."
    }
  ],
  "media": [
    {
      "media_id": "00000000-0000-4000-8000-000000000000",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "kind": "...",
      "stage": "...",
      "summary": "..."
    }
  ]
}

Errors

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