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

Authentication

Send your API key as a bearer token.
Deleting a webhook requires the workspace admin role. tech and 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

Pause instead of delete

Set is_active: false to stop deliveries reversibly.

Create a webhook

Register a replacement endpoint.

List webhooks

Confirm what is left in the workspace.

Error reference

Every status code the API returns.