Skip to main content

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.

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

HeaderRequiredDescription
AuthorizationYesBearer oth_YOUR_API_KEY

​
Path parameters

​
id
string
required
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

CodeDescription
not_foundNo subscription with the given ID exists under your API key.
unauthorizedThe Authorization header is missing or the API key is invalid.