Register Asset

POST/v1/assets

Register a publicly accessible media URL and receive a persistent asset:// reference.

Request body

stringurlrequired

Non-empty source URL forwarded to the Asset provider. The provider must be able to fetch it.

Image | Video | Audioasset_typerequired

Case-sensitive asset type.

Optional<string>name

Optional display name.

curl -X POST https://api.sandbase.ai/v1/assets \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/tea-ad.mp4",
    "asset_type": "Video",
    "name": "Tea ad reference video"
  }'

Response200 OK

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "asset_url": "asset://asset-20260710150403-hx4hf",
  "asset_type": "Video",
  "name": "Tea ad reference video",
  "created_at": "2026-07-10T15:04:03Z"
}