Skip to content

Delete a webhook endpoint

View as Markdown Open in Claude

DELETE/v1/webhook-endpoints/{endpointId}

Stops and removes the endpoint and its delivery history. The events themselves stay in GET /events for 30 days.

Permissions: any valid key · Kind: write · Cost: 1 unit

Cannot be undone.

Path parameters

Field	Type	Required	Description
`endpointId`	uuid	yes

Query parameters

None.

Response `200`

Field	Type	Required	Description
`object`	"webhook_endpoint"	yes
`id`	uuid	yes
`deleted`	true	yes

Errors

Errors are problem details. Besides the refusals described above, any call like this one can return:

invalid_request — Invalid request
unauthorized — Missing or invalid API key
insufficient_scope — Missing permission
rate_limited — Rate limit reached
not_found — Not found
idempotency_key_reused — Idempotency-Key reused
request_in_progress — Request in progress
forbidden — Not allowed

Examples

curl

curl -X DELETE https://api.bymundi.com/v1/webhook-endpoints/$ENDPOINT_ID \
  -H "Authorization: Bearer $BYMUNDI_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

JavaScript

const res = await fetch(`https://api.bymundi.com/v1/webhook-endpoints/${endpointId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.BYMUNDI_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
  },
});
if (!res.ok) throw new Error((await res.json()).detail);
const data = await res.json();

Python

import os, uuid, requests

res = requests.delete(
    f"https://api.bymundi.com/v1/webhook-endpoints/{endpointId}",
    headers={"Authorization": f"Bearer {os.environ['BYMUNDI_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
)
res.raise_for_status()
data = res.json()