Skip to content
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_idstringRequired
The 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
successboolean
Always true on success.
dataobject
The deleted voice.

Errors

HTTPCodeWhen
400INVALID_VOICE_IDThe ID isn't a valid jsf_ ID.
403CANNOT_DELETE_DEFAULT_VOICEYou tried to delete a default voice.
404VOICE_NOT_FOUNDNo 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
  }
}