Skip to content
Documentation navigation
On this page

Delete an Asset

Delete an asset in the current organization. Requires Bearer authentication.

http
DELETE /v1/assets/{id}

Path parameters

ParameterTypeRequiredDescription
idinteger (int64)YesID of the asset to delete.

No request body is required.

Example request

Replace 123456789 with the asset ID.

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

Response

A successful deletion returns HTTP 200 OK.

json
{ "id": 123456789 }
FieldTypeDescription
idinteger (int64)ID of the deleted asset.

A deleted asset cannot be retrieved or used in new generation requests. Retrieving or deleting it again returns 404. Deleting an asset does not cancel generations, and previously issued URLs may remain valid. Wait for related generations to finish before deleting input assets.

Accessing another organization's asset returns 403. See Asset Errors for error codes.