Tra cứu API
Huỷ việc
job_cancel — Cancel a job.
job_cancel · Xoá / không hoàn tác
Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.
Cancel a job. Waiting or held jobs are cancelled for sure. A running job is asked to stop: it ends cancelled, or succeeded if X already did it, or unknown if it passed the point of no return.
| REST | POST /api/public/v1/jobs/{job_id}/cancel |
| Công cụ MCP | job_cancel |
| Quyền cần có | accounts.run — Chủ, Quản lý, Vận hành |
| Nhóm quyền | x:engage |
| Nhóm | Lõi: nick, việc, tìm công cụ |
| Hiện sẵn trong hồ sơ | mọi hồ sơ (bộ lõi) |
Đầu vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
job_id |
string (uuid) | Có | Job to cancel. |
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.
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 POST "https://reach-link-craft.lovable.app/api/public/v1/jobs/00000000-0000-4000-8000-000000000001/cancel" \
-H "Authorization: Bearer $XBUDDY_API_KEY" \
-H "Idempotency-Key: 6f1c2a90-example-key" \
-H "Content-Type: application/json" \
-d '{}'
Gọi qua MCP
{
"method": "tools/call",
"params": {
"name": "job_cancel",
"arguments": {
"job_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 |
not_found |
404 | Không |