cURL
curl --location --request DELETE 'https://api.inworld.ai/voices/v1/pvcVoices/<voice-id>' \
--header "Authorization: Basic $INWORLD_API_KEY"import requests
voice_id = "<voice-id>"
url = f"https://api.inworld.ai/voices/v1/pvcVoices/{voice_id}"
headers = {"Authorization": "Basic <api-key>"}
response = requests.delete(url, headers=headers)
print(response.json())const voiceId = '<voice-id>';
const url = `https://api.inworld.ai/voices/v1/pvcVoices/${voiceId}`;
const response = await fetch(url, {
method: 'DELETE',
headers: { 'Authorization': 'Basic <api-key>' },
});
const data = await response.json();
console.log(data);{}{
"code": 9,
"message": "pvc voice 'my-professional-voice' cannot be deleted while in state PVC_VOICE_STATE_READY",
"details": []
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Professional Voice Cloning
Delete a PVC voice
Deletes a PVC voice and all of its uploaded samples. Only allowed while the voice is PVC_VOICE_STATE_DRAFT or PVC_VOICE_STATE_FAILED. A PVC_VOICE_STATE_READY voice cannot be deleted through this API; its slot is released when the trained voice it produced is deleted via the Voices API.
DELETE
/
voices
/
v1
/
pvcVoices
/
{voiceId}
cURL
curl --location --request DELETE 'https://api.inworld.ai/voices/v1/pvcVoices/<voice-id>' \
--header "Authorization: Basic $INWORLD_API_KEY"import requests
voice_id = "<voice-id>"
url = f"https://api.inworld.ai/voices/v1/pvcVoices/{voice_id}"
headers = {"Authorization": "Basic <api-key>"}
response = requests.delete(url, headers=headers)
print(response.json())const voiceId = '<voice-id>';
const url = `https://api.inworld.ai/voices/v1/pvcVoices/${voiceId}`;
const response = await fetch(url, {
method: 'DELETE',
headers: { 'Authorization': 'Basic <api-key>' },
});
const data = await response.json();
console.log(data);{}{
"code": 9,
"message": "pvc voice 'my-professional-voice' cannot be deleted while in state PVC_VOICE_STATE_READY",
"details": []
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Deletes the voice and every sample uploaded to it. Only allowed while the voice is
PVC_VOICE_STATE_DRAFT or PVC_VOICE_STATE_FAILED.
A
PVC_VOICE_STATE_READY voice cannot be deleted through this API — this endpoint returns 409 and the PVC record is permanent. Its slot is released when the trained voice it produced is deleted, via the Portal voice library or DELETE /voices/v1/workspaces/{workspace}/voices/{voice}.Authorizations
Your API key. Read permissions are required for GET endpoints. Write permissions are required for POST, PATCH, and DELETE endpoints.
For Basic authentication, please populate Basic $INWORLD_API_KEY. You can create a key in one command with the Inworld CLI: inworld workspace add-key.
Path Parameters
Voice ID of the PVC voice to delete.
Response
A successful response.
The response is of type object.