Tra cứu API
Xoá điểm nhận webhook
webhook_delete — Delete the endpoint and its delivery log.
webhook_delete · Xoá / không hoàn tác
Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.
Delete the endpoint and its delivery log. Events stay readable with events_list.
| REST | DELETE /api/public/v1/webhooks/{endpoint_id} |
| Công cụ MCP | webhook_delete |
| Quyền cần có | integrations.manage — Chủ, Quản lý |
| Nhóm quyền | webhooks:manage |
| Nhóm | Sự kiện và webhook |
| Hiện sẵn trong hồ sơ | Hạ tầng |
Đầu vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
endpoint_id |
string (uuid) | Có | Endpoint id. |
Kết quả
Trả về kết quả của thao tác trong phong bì { data, meta }.
Cần khoá idempotency (Idempotency-Key, 8–128 ký tự). Gửi lại cùng khoá không bao giờ làm lại việc.
Thao tác này xoá dữ liệu hoặc không hoàn tác được. Hỏi lại người dùng trước khi gọi.
Ví dụ
Gọi qua REST
curl -X DELETE "https://reach-link-craft.lovable.app/api/public/v1/webhooks/00000000-0000-4000-8000-000000000001" \
-H "Authorization: Bearer $XBUDDY_API_KEY" \
-H "Idempotency-Key: 6f1c2a90-example-key" \
-H "Content-Type: application/json" \
-d '{}'
Gọi qua MCP
{
"method": "tools/call",
"params": {
"name": "webhook_delete",
"arguments": {
"endpoint_id": "00000000-0000-4000-8000-000000000001",
"idempotency_key": "6f1c2a90-example-key"
}
}
}
Lỗi có thể gặp
| Mã | HTTP | Thử lại được |
|---|---|---|
unauthorized |
401 | Không |
key_expired |
401 | Không |
integration_revoked |
401 | Không |
connection_not_linked |
403 | Không |
integration_paused |
403 | Không |
workspace_integrations_paused |
403 | Không |
integration_authorization_lost |
403 | Không |
workspace_suspended |
403 | Không |
forbidden |
403 | Không |
invalid_input |
422 | Không |
rate_limited |
429 | Có |
internal |
500 | Có |
read_only |
403 | Không |
idempotency_key_required |
428 | Không |
idempotency_conflict |
409 | Không |
idempotency_processing |
409 | Có |
conflict |
409 | Không |
precondition_failed |
422 | Không |
not_found |
404 | Không |