Delete a Voice

Deletes a voice clone owned by the caller. The voice must not be in use by any template. The voice is removed from your voice list and no longer counts against your voice clone limit. Deleting an already-deleted or unknown voice returns 404 voice_not_found (not 200) — a delete-then-list flow should treat that 404 as success, not an error.

DELETE /v3/voices/{voice_id}

Delete a Voice

cURL

curl --request DELETE \
  --url https://api.heygen.com/v3/voices/{voice_id} \
  --header 'x-api-key: <api-key>'

200

{
  "data": {
    "voice_id": "<string>"
  }
}

Authorizations

ApiKeyAuthBearerAuth

x-api-key · string · header · required

HeyGen API key. Obtain from your HeyGen dashboard.

Path Parameters

voice_id · string · required

Unique voice identifier

Response

200

application/json

Successful response

data · VoiceDeleteV3Response · object

Response for DELETE /v3/voices/{voice_id}.

Show child attributes