media.requestCapture

Hosted photo capture: a signed upload URL for a worker taking a photo in the browser.


Who	Hosted page only (a person does it in the browser)
REST	`POST /v1/media/capture`
MCP tool	Not an MCP tool
Writes	no
Area	Job photos

When to use it

Never call it yourself. Used by the hosted camera page when a worker takes a photo in the browser.

What to tell the owner

Open the job's camera page to take photos.

Input

Field	Type	Required
`job_id`	string	yes
`stage`	string (one of before, during, after, other)	yes
`sha256`	string	yes
`shows_interior`	boolean	no

Example

POST https://doingwork.work/v1/media/capture
content-type: application/json
Idempotency-Key: 3f1c...

{
  "job_id": "00000000-0000-4000-8000-000000000000",
  "stage": "before",
  "sha256": "..."
}

Output

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
`human_only`	403	This step happens on a hosted page the person opens themselves. Send them the link; don't try another route.
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.