Get Asset

GET/v1/assets/{asset_id}

Retrieve Asset metadata and a temporary signed download URL.

Path parameters

stringasset_idrequired

External Asset ID, without the asset:// prefix.

Provider-managed URL

The asset:// value is the reusable Asset reference. download_url is provider-managed and can be empty; query this endpoint again for its current value.

curl https://api.sandbase.ai/v1/assets/asset-20260710150403-hx4hf \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "external_id": "asset-20260710150403-hx4hf",
  "asset_url": "asset://asset-20260710150403-hx4hf",
  "status": "Active",
  "asset_type": "Video",
  "download_url": "https://cdn.example.com/signed-url",
  "created_at": "2026-07-10T15:04:03Z"
}