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.

WhoAgents can call this
RESTGET /v1/media
MCP toolmedia_list
Writesno
AreaJob 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

FieldTypeRequired
job_idstring (uuid)no
shop_idstring (uuid)no
near_latnumberno
near_lngnumberno
radius_mnumberno
taken_afterstringno
taken_beforestringno
has_locationstring (one of true, false)no
sortstring (one of uploaded, taken, taken_desc, distance)no
limitintegerno
kindstring (one of photo, video)no
qstringno
summary_statusstring (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=summarized

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
not_found404No such record, or this worker can't see it.
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.