Skip to main content

Delete an incoming webhook (reference-checked)

DELETE 

/v1/webhooks/incoming/:webhook_id

Delete an incoming webhook.

The call is reference-checked: if any active workflow still binds this webhook through a live webhook trigger, it returns 409 and names those workflows instead of silently breaking them. Pass force=true to delete anyway.

By default the URL is retired but the registry row is kept, so past deliveries remain explainable; pass permanent=true to hard-delete the record.

Requires the webhooks:write scope.

Request

Responses

Successful Response