Skip to main content
DELETE
/
v1
/
custom-voices
/
{voice_id}
Delete cloned voice
curl --request DELETE \
  --url https://supertoneapi.com/v1/custom-voices/{voice_id} \
  --header 'x-sup-api-key: <api-key>'
{
  "status": "error",
  "message": {
    "message": "Invalid API Key",
    "error": "Unauthorized",
    "statusCode": 401
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Permanently removes a custom voice. This is irreversible.
Existing audio clips you’ve already generated with the voice are not affected. Only the voice itself is removed — future TTS calls referencing the deleted voice_id will return 404 Not Found.

​
Endpoint

DELETE https://supertoneapi.com/v1/custom-voices/{voice_id}

​
Path parameters

NameRequiredDescription
voice_id✅The ID of the custom voice to delete.

​
Response

Returns 200 OK on success with an empty body.

​
Errors

StatusCause
404 Not FoundThe voice doesn’t exist on your account.
403 ForbiddenThe voice belongs to a different account.

​
See also

Docs: Custom voices

Full custom-voice lifecycle.

List custom voices

Browse your custom voices before deleting.

Authorizations

​
x-sup-api-key
string
header
required

Path Parameters

​
voice_id
string
required

Response

Voice deleted successfully