shares.create

Make a link to a gallery of a job's photos that anyone with the link can open without signing in. Name the photos, or leave media_ids out to share every photo on the job (including ones added later). Expires after days (1 to 90, default 14); revoke it any time. Markup shows over the photos unless include_markup is false. Set include_daily_log to also show the job's daily log entries (off by default; names of who wrote them are not shown). The url is shown once.


Who	Agents can call this
REST	`POST /v1/shares`
MCP tool	`shares_create`
Writes	yes, send an Idempotency-Key
Area	Job photos

When to use it

Make a link to a gallery of a job's photos that anyone with the link can open without signing in. Name the photos, or leave media_ids out to share every photo on the job (including ones added later).

What to tell the owner

Say what you did in plain words and what happens next.

Input

Field	Type	Required
`job_id`	string (uuid)	yes
`media_ids`	array	no
`days`	integer	no
`title`	string	no
`include_markup`	boolean	no
`include_daily_log`	boolean	no

Example

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

{
  "job_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

Code	Status	What to do
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.