Skip to main content

Delete Real-Person Asset

DELETE /api/volc-user/assets

Delete the current user's real-person asset. Its platform ID can no longer be used for new video tasks.

A successful response means the local deletion has committed: the asset immediately becomes invisible and unavailable for new tasks. Upstream resources and platform source files are cleaned up asynchronously. Cleanup progress, failures, and retries are available only in the admin console.

Video tasks referencing these assets are cancelled and their reserved quota refunded under existing rules if they have not been submitted upstream. Submitted tasks and tasks with an unconfirmed submission outcome continue to converge; their resources are retained until the tasks reach a confirmed terminal state.

Repeating deletion for an already-deleted resource owned by the same user succeeds without creating duplicate cleanup work. Missing or inaccessible resources still return a failure.

Authentication

Use a logged-in session Cookie or the Authorization: <access_token> header. Obtain the access token through Generate Access Token. It is different from the sk- key used for model requests.

Request Parameters​

NameTypeRequiredDescription
idstringRequiredPlatform asset ID to delete (JSON body)

Request Example​

DELETE /api/volc-user/assets
Authorization: <access_token>
Content-Type: application/json

{
"id": "asset-example"
}

Response Fields (200)​

NameTypeDescription
successbooleanWhether local deletion committed; check even for HTTP 200. Physical cleanup may still be pending
messagestringMessage; empty on success
dataobjectResponse data on success
data.idstringPlatform resource ID for this operation

Response Example​

{
"success": true,
"message": "",
"data": {
"id": "asset-example"
}
}