# Remove a Tenant Webhook

Stop telling your server about bank ramp and card onramp events in one environment.

## Overview

- `204` with no body. The webhook and its secret are deleted, and deliveries still waiting are dropped. To stop only for a while, save it with `"status": "disabled"` instead ([Save a Webhook](https://docs.aureahub.com/docs/tenant-webhook-save.md)).
- `404` with `details.code` `NOAH_WEBHOOK_NOT_FOUND` when the environment has no webhook.
- For a tenant role that manages the webhooks — `owner`, `tenantadmin`, `non_signing_admin` or `security_admin` ([Roles](https://docs.aureahub.com/docs/authentication.md)), on its own tenant. Written to the tenant's activity log with the address.

> ℹ️ **Your tenant's quorum, where Aurea enables it for your tenant** (a tenant on the institutional security profile by its profile): 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}/webhooks/{environment}`

Authentication: bearer token required.

Deletes the environment's webhook and its secret.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |
| `environment` | string | yes | `production` or `sandbox` |

**Responses**

`204` No Content

`202` Awaiting quorum

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

`404` No webhook

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "This tenant has no webhook in sandbox",
  "details": { "code": "NOAH_WEBHOOK_NOT_FOUND" }
}
```

---

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