> ## Documentation Index
> Fetch the complete documentation index at: https://docs.offthehook.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /v1/subscriptions/:id

> Permanently delete a subscription and all its address filters. In-flight deliveries may still complete. This action cannot be undone.

Use this endpoint to permanently delete a subscription. All address filters associated with the subscription are removed at the same time. Once deleted, the subscription ID cannot be recovered and no further events will be queued for delivery.

## Request

**`DELETE /v1/subscriptions/:id`**

### Headers

| Header          | Required | Description               |
| --------------- | -------- | ------------------------- |
| `Authorization` | Yes      | `Bearer oth_YOUR_API_KEY` |

### Path parameters

<ParamField path="id" type="string" required>
  The subscription ID to delete. Always starts with `sub_`.
</ParamField>

### Example request

```bash theme={null}
curl -X DELETE https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN... \
  -H "Authorization: Bearer oth_YOUR_API_KEY"
```

## Response

**`204 No Content`**

The response body is empty. A `204` status confirms the subscription has been deleted.

<Warning>
  Deleting a subscription removes all its address filters permanently. Webhook deliveries that were already queued before deletion may still be delivered to your endpoint — disabling a subscription first gives in-flight deliveries time to complete before you remove the resource entirely.
</Warning>

## Errors

| Code           | Description                                                      |
| -------------- | ---------------------------------------------------------------- |
| `not_found`    | No subscription with the given ID exists under your API key.     |
| `unauthorized` | The `Authorization` header is missing or the API key is invalid. |