Skip to content
Webhooks

Delete a webhook endpoint

DELETE/api/v1alpha1/webhooks/{webhook_id}

Deletes a webhook endpoint and stops all further deliveries to it.

  • Access: an alpha-enabled API key with the MANAGE_WEBHOOKS permission.
  • Response: no body.
  • Retries: Idempotency-Key applies to POST endpoints only, so repeating a DELETE is not deduplicated.
  • Not found: an endpoint in another workspace is deliberately indistinguishable from one that does not exist.

Once the endpoint is gone its delivery history can no longer be read through this API, so export anything you need for audit first.

AuthorizationBearer <token>

In: header

Path Parameters

webhook_id*string

Identifier of a registered webhook endpoint.

Response Body

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/api/v1alpha1/webhooks/wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \  -H "Authorization: Bearer $DEEPFRAME_API_KEY"
Empty