Tra cứu API

Xoay khoá ký webhook

webhook_rotate_secret — New signing secret, returned ONCE.

webhook_rotate_secret · Đổi thiết lập trong X-Buddy

Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.

New signing secret, returned ONCE. For 24 hours both the new and the previous secret sign every delivery (two v1 signatures), so the receiver can switch without losing events.


REST	`POST /api/public/v1/webhooks/{endpoint_id}/rotate-secret`
Công cụ MCP	`webhook_rotate_secret`
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.

Ví dụ

Gọi qua REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/webhooks/00000000-0000-4000-8000-000000000001/rotate-secret" \
  -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_rotate_secret",
    "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

Về danh sách thao tác

Xoay khoá ký webhook

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP