Skip to main content
DELETE
Deletes a webhook. Encrata stops delivering to it immediately.

Authentication

Send your Encrata API key in the Authorization header with the Bearer prefix.
Deleting a webhook requires the workspace admin or tech role. readonly keys get 403.

Request

Pass the webhook ID in the path.
string
required
The webhook ID to delete.
The ID is also accepted in a JSON body sent to DELETE /api/webhooks for backwards compatibility:
string
The webhook ID to delete. Used only when the path contains no ID.
Deleting a webhook removes the endpoint. Its delivery history is retained, but you can no longer read it: list deliveries returns 404 once the webhook is gone. Export anything you need first.

Examples

Response

Returns 200 OK.
boolean
true when the webhook was deleted.
object
string
A human-readable summary.
Example response

Errors

Example error

Next steps