DELETE /webhooks/{id}
Delete a subscription
| Scope | webhooks:delete |
| Cost | Free |
Permanently removes a subscription. Returns 204 with an empty body —
there's nothing to return. Deletion can't be undone, so if you might want
the subscription back, disable it instead (POST /webhooks/{id}/disable),
which needs only webhooks:write. Deleting needs webhooks:delete;
webhooks:write alone is not enough.
Path parameters
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
id | integer | yes | 2074 | The subscription id. |
Responses
204
Deleted. No body.
Errors
| Status | Meaning |
|---|---|
401 | unauthenticated — no credential, or one that is invalid, revoked or expired. The WWW-Authenticate header names the scope the endpoint wanted. |
403 | Two different failures share this status; the type field tells them apart — insufficient_scope (the credential lacks the scope) or permission_denied (the scope is fine, but the user's role lacks the permission). |
404 | not_found — no such object, or it is not this account's. The two are deliberately indistinguishable. |
500 | internal_error — something failed on our side, not with your request. Safe to retry. |
See Errors for the full catalog and what to do about each.
Example
curl -X DELETE 'https://api.account.telebroad.com/api/public/v1/webhooks/2074' \
-H "Authorization: Bearer $TB_KEY"