Skip to the page
Chapters

Webhook endpoints

Delete a webhook endpoint

DELETE/api/v1/webhook_endpoints/{id}

Removes the endpoint and its deliveries: nothing more is sent to it. Deleting an endpoint that is already gone is not found.

Needs a key with submit permission.

Request

Path parameters

Path parameters
NameTypeRequiredDescription
idstringrequiredA webhook endpoint ID (whe_...).

Response

The endpoint that was deleted. Status 200.

Response fields
NameTypeDescription
idstringAn ID that starts with whe_.
objectstringAlways `webhook_endpoint`.
deletedbooleanAlways `true`.

Errors

Errors
HTTP statusCodeWhat it means
401UNAUTHORIZEDA valid API key is required. Send it as "Authorization: Bearer <key>".
403PERMISSION_DENIEDThis API key is not allowed to do that.
404NOT_FOUNDNot found.
422INVALID_REQUESTThe request is not valid.
504TIMEOUTThe request took too long to finish. It may still have taken effect: look it up before sending it again with a new Idempotency-Key. What it made is found with GET /api/v1/eligibility?request_id=<this request_id>, and the same filter on /api/v1/claims and /api/v1/attachments (a key with read permission).
500INTERNALSomething went wrong on our side. Quote the request ID if you contact us.

Example

Example request

Shell
curl -X DELETE "https://sandbox.myclaimhouse.com/api/v1/webhook_endpoints/whe_01JM000000E008000000000021" \
  -H "Authorization: Bearer $CLAIMHOUSE_KEY"

Example response: 200

JSON
{
  "id": "whe_01JM000000E008000000000021",
  "object": "webhook_endpoint",
  "deleted": true
}