> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagentbank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete webhook

> Soft-disable a merchant webhook endpoint.

```text theme={null}
DELETE /v1/merchant/webhooks/:endpointId
```

**Authentication:** `Authorization: Bearer <portal_jwt>`.

## Path parameters

| Parameter | Required | Description |
| - | - | - |
| `endpointId` | Yes | Merchant-owned `mwe_...` endpoint ID. |

## Request

This request has no body.

```bash theme={null}
curl -sS -X DELETE "$AGENTBANK_BASE_URL/v1/merchant/webhooks/mwe_..." \
  -H "Authorization: Bearer $PORTAL_JWT"
```

## Response

```json theme={null}
{
  "endpoint_id": "mwe_...",
  "url": "https://merchant.example/webhooks/agentbank",
  "status": "disabled",
  "signing_scheme": "hmac_sha256_v1",
  "created_at": "2026-08-19T08:00:00.000Z",
  "updated_at": "2026-08-19T08:20:00.000Z",
  "disabled_at": "2026-08-19T08:20:00.000Z"
}
```

Deletion stops future deliveries but does not revoke prior deliveries or alter
their signatures. A disabled endpoint cannot be re-enabled; create a new one.