---
title: "Request Segment Download"
method: POST
path: "/segments/{segment_id}/download"
tags: ["Shorts"]
---

# Request Segment Download

`POST /segments/{segment_id}/download`

Requests the HD rendering and download of a segment. If the HD version is already available, returns the download URL immediately. Otherwise, queues the rendering job and returns a `downloading` status.

## Path parameters

- `segment_id` string, required

## Response `200`

200

- object
  - `status` 'ready' | 'downloading' — `ready` if the HD version is available, `downloading` if rendering was queued.
  - `download_url` string — Signed URL to download the HD segment. Present when `status` is `ready`.
  - `estimated_time` number — Estimated rendering time in seconds. Present when `status` is `downloading`.

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/pandavideo/apis/api-v2.md) · [All operations](https://skmtc.net/pandavideo/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandavideo/api-v2/versions/4fbd3c623ca9/schema)