API reference · Schema
DownloadLink
A short-lived link to one download (valid 5 minutes), bound to one object of the caller's project
objectstringrequiredAlways `download_link`: the type of this object
One of
download_linkurlstringrequiredAbsolute URL of the download; works without credentials until `expires_at`
pathstringrequiredThe same link relative to the API origin (`/v1/downloads?token=…`)
filenamestringrequiredThe name the download is saved under
bytesintegerrequiredSize in bytes
expires_atstring (date-time)requiredWhen it expires (null: never) (ISO 8601, UTC)
Example
{
"object": "download_link",
"url": "https://api.example.com/v1/downloads?token=dl1.eyJr….Zm9v",
"path": "string",
"filename": "string",
"bytes": 1,
"expires_at": "2026-01-01T00:00:00.000Z"
}Used by
- A short-lived link to download a file's content without credentials
POST /v1/files/{file_id}/download-link - A short-lived link to download an artefact tar without credentials
POST /v1/fine-tunes/{fine_tune_id}/download-link