Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Assets

Generates a download link for a specific asset (image)

GET
/v1_1/{cloud_name}/{resource_type}/download

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.

resource_type*string

The type of resource (image, video, or raw).

Value in

  • "image"
  • "video"
  • "raw"

Query Parameters

public_id*string

The public ID of the asset.

format?string

The format to convert the asset to before downloading.

type?string

The delivery type of the asset. Default is "upload".

Value in

  • "upload"
  • "private"
  • "authenticated"
expires_at?integer

Unix timestamp indicating when the download URL should expire.

Formatint64
attachment?boolean

Whether to force download as an attachment.

Defaultfalse
target_filename?string

The desired filename for the downloaded file.

transformation?string

A transformation to apply to the asset before downloading.

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/image/download?public_id=string&api_key=472851639284736&signature=c08ed49d293e966cbe613a13d8e9476fdb76817bd668feb5b17001b168579fbc&timestamp=1623087658"
"string"

Updates an existing asset's identifier (public ID) and optionally other metadata in your Cloudinary account POST

Previous Page

Apply operations on an existing asset POST

Applies actions such as transformations, tags, or metadata updates to an existing asset without re-uploading it. This is useful for applying new transformations, adding tags, or updating metadata on assets that are already in your cloud. Note: Always prefer delivery URL transformations over this method, unless eager transformations are specifically required.