Tra cứu API

Chấp nhận / xoá yêu cầu tin nhắn

dm_request_resolve — Accept a message request (it moves to the inbox and the person can see the account read it) or delete it, with X's own buttons; read back from both lists.

Bản Markdown

dm_request_resolve · 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.

Accept a message request (it moves to the inbox and the person can see the account read it) or delete it, with X's own buttons; read back from both lists. Only conversations marked as a request (inbox_list_threads request=true). Already in that state = changed=false. Not limited.


REST	`POST /api/public/v1/accounts/{account}/actions/message-request`
Công cụ MCP	`dm_request_resolve`
Quyền cần có	`inbox.reply` — Chủ, Quản lý, Vận hành
Nhóm quyền	`inbox:send`
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.
`thread_id`	string (uuid)	Có	X-Buddy conversation id of the request (inbox_list_threads).
`decision`	`accept` · `delete`	Có

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/message-request" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"thread_id":"00000000-0000-4000-8000-000000000001","decision":"accept"}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "dm_request_resolve",
    "arguments": {
      "account": "@your_x_account",
      "thread_id": "00000000-0000-4000-8000-000000000001",
      "decision": "accept",
      "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ấp nhận / xoá yêu cầu tin nhắn

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP