Get asset download metadata
Source-generated GET /assets/{asset_id} reference: authentication, fields, responses, errors, and operational safeguards.
On this page
Operation
GET /assets/{asset_id}
operationId: get_asset_v1_assets__asset_id__get
Read an owned asset and issue a fresh short-lived signed download URL. Save the asset ID, not its expiring URL. The download itself must not include API credentials, including after storage redirects. Ownership and retention still apply.
Authentication and side effects
Use a server-side Bearer API key. Required scope: animations:read
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. |
Responses
| HTTP | Body | Meaning |
|---|---|---|
200 |
AssetResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
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 |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
Response example
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-asset",
"format": "clip_video",
"id": "00000000-0000-4000-8000-000000000003",
"mime_type": "video/mp4",
"object": "asset"
}
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