Skip to main content
GET
Get a presigned download URL for a specific version

Authorizations

Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Path Parameters

username
string
required

The username associated with the request.

namespace
string
required

Namespace for the dataset.

assetId
string<uuid>
required

The data asset's id.

versionNo
integer
required

The version number.

Query Parameters

ttl
integer

Presigned download URL lifetime in seconds (default 900, max 3600).

Response

The version's download URL

versionNo
integer
required
downloadUrl
string
required

Presigned GET URL, valid until expiresAt. Send no Authorization header - the signature is the credential.

A Content-Disposition: attachment naming the asset is signed into the URL, so S3 returns it on the response and a browser saves the file under the asset's name rather than the opaque S3 key. Because it is part of the signature it cannot be overridden by the caller. Every version of an asset downloads under the same name, so saving two versions to one directory will collide - rename client-side if that matters.

expiresAt
string<date-time>
required