Tra cứu API
Đổi trạng thái cuộc trò chuyện trên X
dm_conversation_set_state — Mark a conversation unread / read, mute / unmute or pin / unpin it in the account's own X Chat inbox, through the row menu X shows, each read back after the inbox reloads.
dm_conversation_set_state · 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.
Mark a conversation unread / read, mute / unmute or pin / unpin it in the account's own X Chat inbox, through the row menu X shows, each read back after the inbox reloads. Give only the states to change; one already there is changed=false with no click. Only the account sees these states (nothing is sent to the person); a later inbox sync that opens the conversation marks it read again. Refused while X Chat is locked without a working saved passcode. Not limited.
| REST | POST /api/public/v1/accounts/{account}/actions/conversation-state |
| Công cụ MCP | dm_conversation_set_state |
| 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 (inbox_list_threads). |
unread |
boolean | Không | true = mark unread on X, false = mark read. |
muted |
boolean | Không | Mute notifications of this conversation on X. |
pinned |
boolean | Không | Pin the conversation to the top of the X Chat inbox. |
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.
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/conversation-state" \
-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"}'
Gọi qua MCP
{
"method": "tools/call",
"params": {
"name": "dm_conversation_set_state",
"arguments": {
"account": "@your_x_account",
"thread_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 |
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 |