Skip to main content
GET
Get a data asset's latest metadata and a presigned download URL

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.

Query Parameters

ttl
integer

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

Response

The latest version's metadata and download URL

assetId
string<uuid>
required
name
string
required
currentVersion
integer
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
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
description
string