Skip to main content

​
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 -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).