Actions17
Asset → Get Download Link
AI-generatedSummary
Generate a signed download URL for an asset.
Inputs
- assetId (required) — 32-character asset ID of the asset to retrieve a download link for.
- key — Version key to use; defaults to 'original' and is typically left unchanged.
- delivery — Delivery mode; either 'download' for a direct file download or 'display' for inline display.
Output shape
object with fields url, assetId, and key (url is a plain text download link).
If the asset does not exist or the API call fails, the response may contain error details; otherwise a success returns the signed URL.
Examples
Example 1: Get a download link for an asset with default settings.
{"assetId":"12345678-90ab-cdef-1234-567890abcdef","key":"original","delivery":"download"}
Example 2: Get a display link for an asset.
{"assetId":"12345678-90ab-cdef-1234-567890abcdef","delivery":"display"}
Example 3: Generate a download URL with a custom version key.
{"assetId":"12345678-90ab-cdef-1234-567890abcdef","key":"v2","delivery":"download"}