# Delete Custom Model

Permanently delete a custom model and every phrase it contains.

```
DELETE https://api.reson8.dev/v1/custom-model/{id}
```

:::caution[This cannot be undone]
Deleting a custom model removes all of its phrases. Transcription requests that
reference the deleted model afterwards are rejected as an unknown custom model, so
update any client still sending its ID first.
:::

## Request

### Headers

| Header         | Value                                         |
|----------------|-----------------------------------------------|
| Authorization  | `ApiKey <api_key>` or `Bearer <access_token>` |

### Path Parameters

| Parameter | Type   | Description              |
|-----------|--------|--------------------------|
| `id`      | string | ID of the custom model   |

### Example

```bash
curl -X DELETE "https://api.reson8.dev/v1/custom-model/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: ApiKey <your_api_key>"
```

```python
import requests

response = requests.delete(
    "https://api.reson8.dev/v1/custom-model/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    headers={"Authorization": "ApiKey <your_api_key>"},
)

response.raise_for_status()
```

## Response

`204 No Content`

The response has no body.

## Errors

| Status | Code              | Description                          |
|--------|-------------------|--------------------------------------|
| 401    | `UNAUTHORIZED`    | Invalid or expired credentials       |
| 404    | `NOT_FOUND`       | Custom model not found               |
| 500    | `INTERNAL_ERROR`  | Unexpected server error              |