Đến nội dung
X-Buddy

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

Về danh sách thao tác