Delete a webhook endpoint

Deletes the endpoint. In-flight retries are cancelled. Past delivery records stay readable for 90 days via the deliveries listing.

Returns { "id": "whk_...", "object": "webhook_endpoint", "deleted": true }.

Scope: webhooks:manage.

DELETE /v1/webhook_endpoints/{id}

Delete a webhook endpoint

cURL

curl --request DELETE \
  --url https://api.vexioncards.one/v1/webhook_endpoints/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "whk_01J9MZX2Q4R8T6VBNM3KLP0D7S",
  "object": "webhook_endpoint",
  "deleted": true
}

Authorizations

Authorization · string · header · required

Your secret API key as a Bearer token: Authorization: Bearer vxn_sk_.... Keys are created and scoped in the dashboard - see Authentication.

Headers

Idempotency-Key · string

Recommended on PATCH and DELETE for safe retries.

Maximum string length: 255

Pattern: ^[a-zA-Z0-9_-]+$

Path Parameters

id · string · required

Endpoint identifier (whk_ prefix).

Pattern: ^whk_[A-Za-z0-9]+$

Response

200

application/json

Deletion confirmed. Delivery stops immediately; undelivered events are not replayed to a re-created endpoint.

id · string · required

The id of the deleted resource.

Example:

"whk_01J9MZX2Q4R8T6VBNM3KLP0D7S"

object · string · required

Always "webhook_endpoint".

Allowed value: "webhook_endpoint"

deleted · boolean · required

Always true - the deletion confirmation marker.