# Remove a Webhook Endpoint

Stop sending events to one endpoint, for good.

## Overview

- `204` with no body. The endpoint and its secret are deleted; deliveries still queued for it finish as `skipped`, and its past deliveries and attempts stay readable. To stop only for a while, [change](https://docs.aureahub.com/docs/webhook-endpoint-change.md) it to `"status": "disabled"`.
- `404` `WEBHOOK_ENDPOINT_NOT_FOUND` for an endpoint that is not this tenant's. Same roles as [Add an Endpoint](https://docs.aureahub.com/docs/webhook-endpoint-add.md); written to the tenant's activity log with the address.

> Note: **Your tenant's quorum** [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md) — where it holds administrators' actions (a tenant on the institutional security profile by its profile; every other tenant's records them only): this call answers `202` `{ "state": "awaiting_quorum", "requestId" }` — the **202** tab below — and nothing is done until another administrator of your tenant approves it; the answer it would have given is then read once by who asked ([Read the Answer](https://docs.aureahub.com/docs/quorum-request-result.md)). With no other administrator able to approve it, it is done at once. [Your Tenant's Quorum](https://docs.aureahub.com/docs/guide-tenant-quorum.md). Every other tenant gets the answers below, unchanged.

## Endpoint

### `DELETE /v1/admin/tenants/{id}/webhook-endpoints/{endpointId}`

Authentication: bearer token required.

Deletes the endpoint and its secret.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |
| `endpointId` | string | yes | The endpoint's id |

**Responses**

`204` No Content

`202` Awaiting quorum

```json
{
  "state": "awaiting_quorum",
  "requestId": "4e2b9c17-8a3d-4f60-b5e1-7c9d0a2f6b38"
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "This tenant has no such webhook endpoint",
  "details": { "code": "WEBHOOK_ENDPOINT_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#webhook-endpoint-remove