Delete a single Volcano Engine material asset owned by the current MaaS user. This endpoint supports Seedance 2.0 workflows by cleaning up material assets that are no longer needed.
Description
Use this endpoint to remove a material asset when it is no longer needed. The request targets one asset by asset_id.
Content types
application/json
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token in the format Bearer YOUR_API_KEY. |
Content-Type | string | Yes | Must be application/json. |
Request body parameters
| Name | Type | Required | Description |
|---|---|---|---|
asset_id | string | Yes | Volcano Engine material asset identifier to delete. |
Example request
curl https://api.apifree.ai/v1/files/volengine/assets/delete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asset_id": "asset_abc123"
}'Response schema
A successful response confirms that the asset was deleted or marked as deleted. The exact response fields can vary by upstream provider, but typical fields include:
| Field | Type | Description |
|---|---|---|
asset_id | string | Deleted asset identifier. |
deleted | boolean | Whether the asset was deleted. |
status | string | Deletion status when available. |
Example response:
{
"asset_id": "asset_abc123",
"deleted": true,
"status": "deleted"
}Errors
Typical error cases include:
- Missing
asset_id - Authentication failure
- Asset not found
- Asset does not belong to the current user
- Upstream asset deletion failure