---
title: "Share Job Gallery"
method: POST
path: "/jobs/gallery/share"
---

# Share Job Gallery

`POST /jobs/gallery/share`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/jobs/gallery/share`
- Auth: API key in header `x-api-key`

Shares a job's attachment gallery via email, SMS, or link. For EMAIL, `to`/`subject`/`body` are required. For SMS, `phone_numbers`/`body` are required (requires the Zuper Connect system-notification policy). `via: LINK` is accepted but, for this job-scoped path, does not actually generate a shareable link (that behavior exists only on the generic folder-share variant of this same handler) — effectively a no-op for LINK on this endpoint.

## Request body

- object
  - `job_uid` string, required
  - `send_to` object, required
    - `via` 'EMAIL' | 'SMS' | 'LINK', required
    - `to` string[]: Required for EMAIL.
    - `cc` string[]
    - `bcc` string[]
    - `phone_numbers` string[]: Required for SMS.
  - `subject` string: Required when via is EMAIL.
  - `body` string: Required when via is EMAIL or SMS. Rendered as a Handlebars template against job details for EMAIL.
  - `expires_at` string: Optional ISO date; must not be in the past.

## Response `200`

200

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/jobs/gallery/share/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)