Files

Range Based Download of a file through a Pre-signed URL

Changed on

This endpoint returns metadata and pre-signed URLs that can be used to download large files in chunks using range-based access.

The response includes the following:

  • The pre-signed URL that supports HTTP range requests for partial downloads
  • The expiration date of the pre-signed URL
  • The size of the file in bytes
  • The MIME type of the file

NOTE:

  • The pre-signed URL is valid for a limited time and must be used within that timeframe.
  • The requester must have at least read-level access to the file.
get/files/{assetId}/download

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/files/{assetId}/download
  • Auth: HTTP bearer

Path parameters

assetIdstring required

A globally unique identifier for the asset

Example:urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174

The ID of the asset to get.

Query parameters

urlTTLinteger
  • Provides a client provided hint for Time-To-Live(TTL) in seconds for the pre-signed download URL.

NOTE:
* The server may adjust it to enforce internal limits. * Clients must rely on the urlExpirationDate field in the response for the actual expiration time.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Response

Success - A pre-signed download URL for the asset

urlstring uri

A URL for the asset

urlExpirationDatestring date-time
sizeinteger

Size of the file in bytes

mediaTypestring

The MIME type of the file

Example response

{
  "mediaType": "application/zip",
  "size": 234567890,
  "url": "https://cloud-storage.adobe.io/download?signature=abc123",
  "urlExpirationDate": "2025-05-13T10:15:30Z"
}

Changes

  • 240b6278279cRevision changes
    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

  • 01600f5358e9Revision changes
    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status