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
| Header | Required | Description |
|---|
Authorization | Yes | Bearer oth_YOUR_API_KEY |
Path parameters
The subscription ID to delete. Always starts with sub_.
Example request
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.
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.
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. |
