Delete a webhook
Delete the webhook identified by id. Requires the manage capability, and the webhook must belong to the caller's organization.
After deletion no further events are delivered to its url; any deliveries already pending retry stop. The deletion is permanent — there is no soft-delete (to pause deliveries without removing the config, set active: false via update instead).
On success returns 204 with an empty body. Errors: 404 not_found if no webhook with that id is owned by the caller's organization; 403 forbidden if the caller lacks the manage capability.
Send Authorization: Bearer <token>. The token can be a login JWT from the frontend or an api-key for a script. JWT access comes from the person's organization role. Api-key access comes from the permissions saved on the key.
In: header
Path Parameters
The webhook id. Must reference a webhook owned by the caller's organization, otherwise the request fails with a 404 "not_found".
"01HHX5WEBHOOK..."Response Body
application/json
curl -X DELETE "https://example.com/api/v1/webhooks/01HHX5WEBHOOK..."{ "error": { "code": "not_found", "details": { "property1": null, "property2": null }, "message": "session not found" }}