media.get

One photo or video's details, including its full summary (findings, readable text, measurements, transcript and key moments), taken time, location, camera fields and the full metadata read from the file. Set include_content to get the stored bytes as base64 (metadata included), or include_original to get the original HEIC or TIFF when the photo was converted.

WhoAgents can call this
RESTGET /v1/media/get
MCP toolmedia_get
Writesno
AreaJob photos

When to use it

Read one photo's details, or its bytes if you need to look at it.

What to tell the owner

Here's that photo.

Input

FieldTypeRequired
media_idstring (uuid)yes
include_contentstring (one of true, false)no
include_originalstring (one of true, false)no

Example

GET https://doingwork.work/v1/media/get?media_id=00000000-0000-4000-8000-000000000000

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.