# Delete a designed voice

`DELETE https://api.paxalabs.com/v1/voices/designed/{id}`

DELETE /v1/voices/designed/{id} deletes a designed voice and frees its slot.

Deleting cannot be undone. New requests in the voice answer [400 unknown_voice](https://paxalabs.com/docs/errors#unknown_voice), including a retry under an earlier [Idempotency-Key](https://paxalabs.com/docs/idempotency), and a live connection already open in the voice keeps it until the connection closes. Deleting costs nothing and takes no rate-limit token.

## Headers

- `authorization` (Bearer pxa_..., required): Authorization: Bearer pxa_... (recommended).
- `x-api-key` (pxa_..., optional): Alternative to the Authorization header. Ignored when Authorization is present.

See authentication at https://paxalabs.com/docs/authentication.

## Path

- `id` (string, required): The designed voice's id, starting "voice_".

## Response

- `id` (string, required): The deleted voice's id.

## Errors

- `unknown_voice` (400): The voice id names no voice on the model's roster and no designed voice this account holds.
- `unauthorized` (401): The request carried no API key, or the key is invalid or disabled.

## Example

curl:

```bash
curl -X DELETE https://api.paxalabs.com/v1/voices/designed/voice_3f9a1c2e7b4d4e8a9c0b1d2e3f4a5b6c \
  -H "Authorization: Bearer $PAXA_API_KEY"
```

Response:

```json
{
  "id": "voice_3f9a1c2e7b4d4e8a9c0b1d2e3f4a5b6c"
}
```