media.list
List the photos and videos you are allowed to see, with what the agent said each shows (summary), who provided each file (shop or customer), the channel it arrived on, taken time, GPS location, heading and camera details. Filter by job, kind, words in the summary or transcript (q), summary status, distance from a point, taken time, or whether it has a location.
| Who | Agents can call this |
| REST | GET /v1/media |
| MCP tool | media_list |
| Writes | no |
| Area | Job photos |
When to use it
See which photos a job has, by stage (before, during, after).
What to tell the owner
Here are the photos on that job.
Input
| Field | Type | Required |
|---|---|---|
job_id | string (uuid) | no |
shop_id | string (uuid) | no |
near_lat | number | no |
near_lng | number | no |
radius_m | number | no |
taken_after | string | no |
taken_before | string | no |
has_location | string (one of true, false) | no |
sort | string (one of uploaded, taken, taken_desc, distance) | no |
limit | integer | no |
kind | string (one of photo, video) | no |
q | string | no |
summary_status | string (one of summarized, needs_summary) | no |
Example
GET https://doingwork.work/v1/media?job_id=00000000-0000-4000-8000-000000000000&shop_id=00000000-0000-4000-8000-000000000000&near_lat=...&near_lng=...&radius_m=...&taken_after=...&taken_before=...&has_location=true&sort=uploaded&limit=1&kind=photo&q=...&summary_status=summarizedOutput
JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.
Errors
| Code | Status | What to do |
|---|---|---|
not_found | 404 | No such record, or this worker can't see it. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |