Retrieve an Asset
Get a file URL for an asset in the current organization. Requires Bearer authentication.
http
GET /v1/assets/{id}
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer (int64) | Yes | Asset 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"
}
| Field | Type | Description |
|---|---|---|
id | integer (int64) | Asset ID. |
url | string | File 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.