Download File

Download a gallery file or follow the redirect to the provider playback URL.

Method

GET /v1/gallery/download/:id

Path Parameters

id · string

Gallery file ID.

Headers

Authorization · string

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

Request Example

cURL

curl -L "https://api.voyantcloud.com/v1/gallery/download/gal_file_123" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -o hero.jpg

Response

• 302 redirect – Videos stored in Cloudflare Stream (or other providers with playback URLs) redirect to the playback URL (hls, dash, or primary).
• 200 OK – For assets stored in R2 or Cloudflare Images, the API streams the binary file with Content-Disposition: attachment.

Files in status: deleting or deleted return 404. Respect the redirect URL’s authentication model (Stream URLs expire if you configured signed delivery).