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

# 删除 Webhook

> 通过 webhookId 永久移除已注册的 Webhook 端点。VelaFi 会立即停止向该回调 URL 推送任何后续事件。

使用此端点永久删除 Webhook 端点。删除后，VelaFi 会立即停止向关联 URL 发送事件通知。已删除的 Webhook 会以 `status: 30` 出现在[Webhook 列表](https://docs.velafi.com/cn/api-reference/webhooks/get-webhook-endpoints.md)中，但无法恢复——如需重新注册相同的 URL 或事件类型，请创建新的 Webhook。

> [!NOTE]
>
> 所有请求都必须在 `X-BH-TOKEN` 请求头中携带通过 `GET /v2/token/generate` 获取的令牌（请参阅[认证](https://docs.velafi.com/cn/api-reference/authentication.md)）。删除操作不可撤销。

## 端点

`DELETE https://api.velafi.com/v2/webhook/{webhookId}`

## 路径参数

**webhookId** `string` *required*

要删除的 Webhook 的唯一 ID。可从 [Webhook 列表](https://docs.velafi.com/cn/api-reference/webhooks/get-webhook-endpoints.md)的响应中获取。

## 响应字段

**code** `number`

HTTP 风格的响应码。`200` 表示成功。

**msg** `string`

可读的状态消息，例如 `SUCCESS`。

**data** `boolean`

Webhook 已删除时为 `true`。

## 示例

```bash cURL theme={null}
curl -X DELETE https://api.velafi.com/v2/webhook/ebab8a9663704e7cbbebe672c7c67912 \
  -H "X-BH-TOKEN: YOUR_TOKEN"
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": true
}
```

> [!WARNING]
>
> 删除操作是永久性的，无法撤销。在某事件类型没有任何有效 Webhook 期间发生的事件不会进入队列。已在队列中的事件不会被取消：如果您在约 15 天内为相同事件类型创建了新的 Webhook，这些事件将携带已删除 Webhook 的 `webhookId` 投递到新 Webhook 的 URL。如需持续接收事件，请立即创建新的 Webhook。


## Related topics

- [更新 Webhook](https://docs.velafi.com/cn/api-reference/webhooks/update-a-webhook.md)
- [获取 Webhook 列表](https://docs.velafi.com/cn/api-reference/webhooks/get-webhook-endpoints.md)
- [删除收款人](https://docs.velafi.com/cn/api-reference/beneficiary/delete-beneficiary.md)
- [删除白名单地址](https://docs.velafi.com/cn/api-reference/crypto-wallet/delete-whitelist-address.md)
- [Webhook 设置](https://docs.velafi.com/cn/api-reference/webhooks/webhook-setup.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.