API ReferenceEndpoints
Delete a voice
DELETE
/api/v1/voices/clones/{voice_id}Send a DELETE request with the voice ID in the path. This deletes the voice and its stored audio sample. Deleting is free.
This can't be undone
Once deleted, the voice_id stops working right away. Any text-to-speech request that uses it returns 404 VOICE_NOT_FOUND.
Path parameters
voice_idstringRequiredThe
jsf_ ID of one of your cloned voices.You can only delete voices cloned with your own account. Default voices (jsf_default_…) can't be deleted and return 403 CANNOT_DELETE_DEFAULT_VOICE.
Returns
200 OK
successbooleanAlways
true on success.dataobjectThe deleted voice.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | INVALID_VOICE_ID | The ID isn't a valid jsf_ ID. |
| 403 | CANNOT_DELETE_DEFAULT_VOICE | You tried to delete a default voice. |
| 404 | VOICE_NOT_FOUND | No voice with this ID exists on your account. |
Request
curl -X DELETE "https://www.jsflabs.io/api/v1/voices/clones/jsf_c3BlZWNoaWZ5X3ZvaWNlX2lk" \
-H "x-api-key: jsf_your_api_key"Response200 OK
Response
{
"success": true,
"message": "Your voice has been deleted.",
"data": {
"voice_id": "jsf_c3BlZWNoaWZ5X3ZvaWNlX2lk",
"name": "Morgan",
"deleted": true
}
}