Tra cứu API

Chặn / bỏ chặn người

user_set_block — Block (blocked=true) or unblock a person as the account, confirming X's sheet; read back from X.

user_set_block · Ghi lên X (tạo việc)

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

Block (blocked=true) or unblock a person as the account, confirming X's sheet; read back from X. Blocking also ends following both ways and unblocking does NOT restore it. Counts against Moderation.


REST	`POST /api/public/v1/accounts/{account}/actions/block`
Công cụ MCP	`user_set_block`
Quyền cần có	`accounts.run` — Chủ, Quản lý, Vận hành
Nhóm quyền	`x:engage`
Nhóm	Thao tác trên X
Hiện sẵn trong hồ sơ	Điều khiển nick

Đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
`account`	string (1–100 chars)	Có	The X account to use: its X-Buddy account_id (from account_list) or its @handle. Ambiguous names return candidates instead of guessing.
`person`	string (1–60 chars)	Có	Person on X: @handle (or handle) or numeric user id prefixed with #, e.g. #44196397
`blocked`	boolean	Không

Kết quả

Tạo một việc cho VPS của nick. REST chờ tối đa wait giây (mặc định 15, tối đa 20): xong thì trả 200 với kết quả, chưa xong thì trả 202 kèm Location: /api/public/v1/jobs/{job_id}. Kết quả cuối có thể là succeeded, failed, cancelled hoặc unknown.

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.

Việc kết thúc unknown có thể đã xảy ra trên X: không gửi lại bằng khoá idempotency mới.

Ví dụ

Gọi qua REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/accounts/%40your_x_account/actions/block" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"person":"@example_person"}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "user_set_block",
    "arguments": {
      "account": "@your_x_account",
      "person": "@example_person",
      "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
`ambiguous_account`	409	Không
`account_not_allowed`	403	Không
`not_found`	404	Không
`agent_too_old`	422	Không
`unsupported_by_account`	422	Không

Về danh sách thao tác

Chặn / bỏ chặn người

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP