Download signed asset
Source-generated GET /assets/{asset_id}/content reference: authentication, fields, responses, errors, and operational safeguards.
On this page
Operation
GET /assets/{asset_id}/content
operationId: download_asset_v1_assets__asset_id__content_get
Download bytes using the complete signed URL returned in an Asset response. No Bearer header is required or recommended. Do not construct signatures or forward credentials to storage. Depending on delivery mode this returns bytes or a 302 redirect. Expired or invalid signatures appear as NOT_FOUND; refresh metadata through GET /assets/{asset_id}.
Authentication and side effects
Use the complete returned signed URL. Do not attach a Bearer key.
This operation does not start paid generation. Other state changes are described above.
Parameters
| Parameter | Location | Type | Required | Constraints / default | Meaning |
|---|---|---|---|---|---|
asset_id |
path |
string |
Yes | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
expires |
query |
integer |
Yes | exclusiveMinimum: 0 |
Use the value in the returned signed URL; never invent or log it. |
signature |
query |
string |
Yes | minLength: 64; maxLength: 64 |
Use the value in the returned signed URL; never invent or log it. |
Responses
| HTTP | Body | Meaning |
|---|---|---|
200 |
string |
Asset bytes; Content-Type depends on the asset. |
302 |
— | Redirect to short-lived storage URL; do not forward credentials. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
Response headers
| HTTP | Header | Type | Meaning |
|---|---|---|---|
302 |
Location |
string |
Short-lived storage download URL. |
Related guides
Was this page helpful?
No search queries, code, or free text are collected. This switch controls documentation interactions only; general site analytics follow the privacy policy. Privacy policy