---
title: "Get Download Url"
method: GET
path: "/segment/{job_id}/download/{layer}/url"
---

# Get Download Url

`GET /segment/{job_id}/download/{layer}/url`

## Request

- Base URL: `https://api.segly.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.segly.io/segment/{job_id}/download/{layer}/url`
- Auth: none declared

Create a signed download URL for a completed job artifact.

Current operational failures require `retry=true`; no-visible-artwork
failures remain terminal. Obsolete export revisions rebuild on demand.

## Path parameters

- `job_id` string, required
- `layer` string, required

## Query parameters

- `retry` boolean

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- DownloadUrlResponse: Signed download URL metadata.
  - `status` 'pending' | 'processing' | 'ready' | 'failed', required
  - `url` string, nullable
  - `expires_in` integer, nullable
  - `message` string, nullable
  - `retry_after_ms` integer, nullable
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/segly/apis/segly-io-api.md) · [All operations](https://skmtc.dev/segly/apis/segly-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/segly/apis/segly-io-api/revisions/f831b05317d0?raw)