Assets

Download an asset by asset ID

GET
/v1_1/{cloud_name}/asset/download

Generates a download link for a specific asset identified by its immutable asset ID, instead of the resource type, delivery type and public ID.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

Query Parameters

asset_id*string

The asset ID of the resource. Must be a 32-character hexadecimal string.

Match^[0-9a-f]{32}$
format?string

The format to convert the asset to before downloading.

transformation?string

A transformation to apply to the asset before downloading.

attachment?boolean

Whether to force download as an attachment.

Defaultfalse
target_filename?string

The desired filename for the downloaded file.

streaming_attachment?boolean

Whether to stream a video asset as an attachment.

expires_at?integer

Unix timestamp indicating when the download URL should expire.

Formatint64
api_key?string

The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.

signature?string

(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.

timestamp?integer

The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.

Formatint64

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/asset/download?asset_id=f4e6579cf84dd9cf5683b21f5b30c7d9&api_key=472851639284736&signature=c08ed49d293e966cbe613a13d8e9476fdb76817bd668feb5b17001b168579fbc&timestamp=1623087658"
"string"