Đến nội dung
X-Buddy

Tra cứu API

Tạm dừng / chạy lại nick

account_set_paused — Pause an X account (nothing runs on it, jobs wait) or resume it.

account_set_paused · Đổ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.

Pause an X account (nothing runs on it, jobs wait) or resume it. Does not clear a safety stop X caused.

REST POST /api/public/v1/accounts/{account}/paused
Công cụ MCP account_set_paused
Quyền cần có accounts.run — Chủ, Quản lý, Vận hành
Nhóm quyền x:engage
Nhóm VPS, proxy và cảnh báo
Hiện sẵn trong hồ sơ Điều khiển nick, Hạ tầng

Đầ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.
paused boolean Có

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/accounts/%40your_x_account/paused" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"paused":false}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "account_set_paused",
    "arguments": {
      "account": "@your_x_account",
      "paused": false,
      "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

Về danh sách thao tác