---
title: "Delete a webhook endpoint"
method: DELETE
path: "/webhook-endpoints/{endpointId}"
tags: ["Webhooks"]
---

# Delete a webhook endpoint

`DELETE /webhook-endpoints/{endpointId}`

## Request

- Base URL: `https://api.braiv.co/v1`
- URL: `https://api.braiv.co/v1/webhook-endpoints/{endpointId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Soft-deletes an endpoint. Future events will no longer be delivered to it. Required scope: `webhooks:write`.

## Path parameters

- `endpointId` string, required

## Response `204`

Endpoint deleted; no response body.

## Other responses

- `401`: A supported authentication header is missing or contains an invalid Public API key.
- `403`: The scope is missing or the endpoint belongs to another principal.
- `404`: The resource does not exist or is not accessible to the caller.
- `429`: The API key exceeded its allowed concurrency or request rate. Retry after in-flight work completes or the limit resets.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/braiv/apis/braiv-public-api.md) - [All operations](https://skmtc.dev/braiv/apis/braiv-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/braiv/apis/braiv-public-api/revisions/8ed0fd0d0a6f?raw)