Skip to content

Download an alternate file

GET
/assets/{id}/alternates/{alternate_id}

Returns one alternate file in full, always as application/octet-stream.

The response has no range support, ETag, caching headers or file name, and doesn’t use the type recorded at upload. Read label and content_type from GET /assets/{id}/alternates if you need them.

Any signed-in account that knows both ids can download it. The asset’s access rules aren’t checked, and the file stays downloadable while the asset is in the trash, until cleanup removes the asset for good.

An alternate that doesn’t exist or belongs to another asset gets 404, as do bytes missing from storage. An id that isn’t a UUID gets a plain-text 400, and other storage failures a plain-text 500.

id
required
string format: uuid

The asset’s id.

alternate_id
required
string format: uuid

The alternate’s id, from GET /assets/{id}/alternates.

The alternate’s bytes.

string format: binary

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed