Asset Management

Download asset content

Redirects (302) to a signed URL for the asset's own bytes, valid for 5 minutes. The asset does NOT need to be published — this is the private read path. The redirect is Cache-Control: private, no-store: the URL is the credential, so follow it and do not keep it.

USE THIS WHEN:

  • Fetching your own asset's bytes from a script, SDK or CLI
  • Previewing an asset you do not want on a public URL

DO NOT USE WHEN:

  • You want a stable, cacheable, public URL → publish the asset (POST /api/v1/assets/update with published=true) and use publicUrl
get/api/v1/assets/{id}/content

Request

  • Base URL: https://api.imagestep.dev
  • URL: https://api.imagestep.dev/api/v1/assets/{id}/content
  • Auth: API key in header Authorization

Path parameters

idstring required

Asset ID

Query parameters

variant'readable' | 'original' | 'preview'

Which stored form to download: readable (default; the image at full size in a type a browser shows — for HEIF, RAW, PSD and the like a rendition ingest writes, the original until it has), original (the bytes as uploaded or produced) or preview (a WebP at most 400 px wide)

Changes

No recorded changes to this operation across all 1 revision of this API.