Delete Voice Character with the specified ID

DELETE

https://v1.vocu.ai/api/voice/{id}

After deletion the voice is treated as non-existent by every subsequent query and generation. This cannot be undone.

Only self-created voices can be deleted here. Purchased market voices are out of scope — passing one of their ids returns VOICE_NOT_FOUND. If the voice came from the asset library or the community, the source-side reference count is decremented as part of the delete.

Deleting does not cancel jobs already submitted or synthesising, and does not refund credits already frozen. The response is just { status: 200 } with no data.

INFO

Deprecated alias: /api/tts/voice/{id}. See the site document "Versions and migration".

INFO

See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Successfully deleted Voice Character

application/json

Deleted (no data)

Bodyapplication/json

Example

{
    "status": 200,
    "message": "OK"
}

🟠401Unauthorized

🟠404Not found

🟠429Rate limited

Modified at 2026-08-23 09:24:46

Upload avatar for the voice character with the specified ID

Get the transcription of a style's reference audio