--- title: shares.create | Doing Work API description: 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. url: https://doingwork.work/docs/reference/shares-create/ --- # 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). When object storage is configured, videos on the job can be included too. 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](https://doingwork.work/docs/reference/#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 ```http 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](https://doingwork.work/docs/errors/). |