Bỏ qua tới nội dung

Huỷ lệnhoperation_cancel

Cancel an operation

Ghi dữ liệuHồ sơ: Lõi (luôn có)Quyền: Lệnh · huỷChống trùng bắt buộc

Cancel the parts of a command that no machine has picked up yet. Work already handed to a machine keeps running; the answer says what was cancelled.

Sửa dữ liệu trong workspace, không chạm WhatsApp.

REST

POST
/api/public/v2/operations/{operationId}/cancel

MCP

operation_cancel

Cùng tên trên cổng đăng nhập /mcp và cổng khoá /api/public/mcp. Thêm idempotencyKey để gọi lại an toàn.

Tham số

TênỞ đâuKiểuBắt buộcMô tả
operationIdđường dẫnuuidBắt buộc—

Không gửi workspaceId: luôn lấy từ khoá hoặc kết nối AI.

curl -X POST "https://<ten-mien-cua-ban>/api/public/v2/operations/3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44/cancel" \
  -H "Authorization: Bearer $WA_AUTO_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Phản hồi (200)

{
  "…": "dữ liệu của thao tác"
}

Lỗi có thể gặp

HTTPcodeÝ nghĩa
400idempotency_key_requiredLệnh POST cần header Idempotency-Key (mỗi lệnh một giá trị mới).
401unauthorizedThiếu khoá/đăng nhập, hoặc khoá không đúng.
403permission_deniedKhoá/kết nối không có quyền này, hoặc vai trò của người tạo không đủ.
404not_foundKhông có đối tượng này, hoặc bạn không được xem nó.
409idempotency_in_progressYêu cầu đầu tiên với Idempotency-Key này còn đang chạy — đợi rồi gọi lại.
422validation_failedDữ liệu gửi lên sai kiểu hoặc thiếu trường — xem `violations`.
422idempotency_conflictCùng Idempotency-Key nhưng nội dung khác lần trước.
422operation_rejectedThao tác đã kiểm và từ chối (số ngoại tuyến, chiến dịch chưa gửi thử…) — `detail` nói lý do.
429rate_limitedQuá 60 yêu cầu/phút cho một khoá hoặc kết nối — đợi theo Retry-After.
503pausedAPI/MCP đang tạm dừng (nút ngắt khẩn của workspace hoặc đội vận hành).

Lỗi theo RFC 9457 (application/problem+json). Xem mọi mã lỗi.

# MCP (JSON-RPC) — tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "operation_cancel",
    "arguments": {
      "operationId": "3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44"
    }
  }
}