Guides

Download

Deliver downloadable ODI

Log in to see full request history

In some cases, it may be necessary to provide the users automatic downloads of ODI.

These options allow you to set additional URL parameters that sets Content-Disposition HTTP headers such that when user accesses the URL via a browser, the image transformation downloads to their device as a file with appropriate extension.

📘

Note that these parameters are in addition to other transformation parameters.

The parameters are described below:-

ParameterDescription
deliverySet this to download
dl_prefixSet this to the name of the download file without the extension
formatMandatory parameter for image downloads to set the format of the file. Do not set this if already set via format option

Example downloadable image URL

The URL below will download a 300x300 image transformation called testimage.jpg to user's device.

https://cdn.filespin.io/api/v1/assets/0c3c6d026858460abc4de1dcb4de15ac/conversions?resize=300,300&delivery=download&dl_prefix=testimage&format=jpg
Path Params
string
required

Asset ID, 32 character alphanumeric UUID

Query Params
string

resize=width,height,fill:color

string
Defaults to my_download

name of the download file without the extension

string
Defaults to jpg

jpg or png

Headers
string
Defaults to q=0.9,image/avif,image/webp,image/jpeg,image/png;
Responses

Response body
object

Language
URL