Tra cứu API

Xoá nhóm nick

account_group_delete — Delete a group (its accounts stay untouched).

account_group_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 a group (its accounts stay untouched). expected_revision required.


REST	`DELETE /api/public/v1/groups/{group_id}`
Công cụ MCP	`account_group_delete`
Quyền cần có	`infra.manage` — Chủ, Quản lý
Nhóm quyền	`automation:write`
Nhóm	Nhóm nick
Hiện sẵn trong hồ sơ	—

Đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
`group_id`	string (uuid)	Có	Group id.
`expected_revision`	integer (1–∞)	Có	The revision you read (optimistic locking); a newer revision fails with revision_conflict.

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.

Thiết lập có phiên bản: gửi expected_revision (hoặc If-Match) bạn đã đọc, nếu không sẽ bị từ chối.

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/groups/00000000-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H 'If-Match: "3"' \
  -H "Content-Type: application/json" \
  -d '{"expected_revision":1}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "account_group_delete",
    "arguments": {
      "group_id": "00000000-0000-4000-8000-000000000001",
      "expected_revision": 1,
      "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
`revision_required`	428	Không
`revision_conflict`	412	Không
`not_found`	404	Không

Về danh sách thao tác

Xoá nhóm nick

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP