Delete Real-Person Asset Group

DELETE /api/volc-user/asset-groups

Delete the current user's real-person group and its assets. Verification is required again to create a new real-person group.

A successful response means the local deletion has committed: the group and every undeleted member asset, including disabled, pending-review, and failed assets, immediately become 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

Name	Type	Required	Description
id	string	Required	Platform group ID to delete (JSON body)

Request Example

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

{
  "id": "group-example"
}

Response Fields (200)

Name	Type	Description
success	boolean	Whether local deletion committed; check even for HTTP 200. Physical cleanup may still be pending
message	string	Message; empty on success
data	object	Response data on success
data.id	string	Platform resource ID for this operation

Response Example

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

Verification history is retained after group deletion, but session queries no longer return its deleted groupId.