Deprecated

Delete Custom Voice (/v1/voices/{voice_id})

SDK

Use the SDK for safer, faster integration than manual HTTP calls.

Soft-delete a custom voice that was created via POST /v1/voices/clone. The voice is removed from your active set and the corresponding custom_voice_slot becomes available for a new clone.

After deletion, the same voice_id returns 404 on subsequent requests. Only the owner of the voice may delete it; other users receive 404.

Returns 204 No Content on success.

DELETE/v1/voices/{voice_id}

cURL

curl --request DELETE \
+  --url https://api.typecast.ai/v1/voices/{voice_id} \
+  --header 'X-API-KEY: <api-key>'

"No Content - Voice deleted successfully. The response body is intentionally empty per RFC 9110; treat any 2xx status as success."

Authorizations

X-API-KEYstringheaderrequired

API key for authentication. You can obtain an API key from the Typecast API Console.

Path parameters

voice_idstringrequired

Custom voice identifier with the uc_ prefix.

Response

204No Content - Voice deleted successfully. The response body is intentionally empty per RFC 9110; treat any 2xx status as success.

cURL

curl --request DELETE \
+  --url https://api.typecast.ai/v1/voices/{voice_id} \
+  --header 'X-API-KEY: <api-key>'

"No Content - Voice deleted successfully. The response body is intentionally empty per RFC 9110; treat any 2xx status as success."