Skip to content
Documentation navigation
On this page

Retrieve an Asset

Get a file URL for an asset in the current organization. Requires Bearer authentication.

http
GET /v1/assets/{id}

Path parameters

ParameterTypeRequiredDescription
idinteger (int64)YesAsset ID returned by the upload endpoint.

Example request

Replace 123456789 with the asset ID.

bash
curl https://api.sand.ai/v1/assets/123456789 \
  -H "Authorization: Bearer $SAND_API_KEY"

Response

A successful request returns HTTP 200 OK.

json
{
  "id": 123456789,
  "url": "https://files.example.com/start-frame.png?signature=example"
}
FieldTypeDescription
idinteger (int64)Asset ID.
urlstringFile URL, or an empty string "" if no URL is currently available.

Signed URLs are valid for 60 minutes. Retrieve the asset again after expiration to obtain a fresh URL. Check that url is not empty before downloading. The download does not require an API key.

A missing or deleted asset returns 404; an asset belonging to another organization returns 403. See Asset Errors for error codes.