Download an asset

A signed URL for the asset’s original file, by the asset’s ID alone, with its filename, media type and size. The URL starts a download until expiresAt, 5 minutes after the response, and needs no API key: send no Authorization header with it. Anyone holding it can download the file. Read this endpoint again for a new URL.

Needs the library:read scope.

GET /assets/{assetId}/download

Download an asset

cURL

curl --request GET \
  --url https://api.zerogen.com/v1/assets/{assetId}/download \
  --header 'Authorization: Bearer <token>'

200

{
  "assetId": "<string>",
  "projectId": "<string>",
  "url": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "filename": "<string>",
  "mimeType": "<string>",
  "sizeBytes": 4503599627370495
}

Authorizations

Authorization · string · header · required

A ZeroGen API key: zg_ for a live key, zg_test_ for a test key.

Path Parameters

assetId · string · required

The asset's ID

Response

200

application/json

Where to download the file.

assetId · string · required

projectId · string · required

url · string · required

A signed storage URL that downloads the original file. Anyone holding it can download the file, so keep it private. GET it without your API key: storage refuses a request that also sends an Authorization header.

expiresAt · string<date-time> · required

When url stops starting downloads; read the endpoint again for a new one

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$

filename · string · required

The name the file downloads under; untrusted content

mimeType · string · required

sizeBytes · integer | null · required

Required range: 0 <= x <= 9007199254740991