Tra cứu API

Xoá một tác vụ

task_delete — Delete a task; its waiting jobs are cancelled.

task_delete · Xoá / không hoàn tác

Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.

Delete a task; its waiting jobs are cancelled. expected_revision required.


REST	`DELETE /api/public/v1/tasks/{task_id}`
Công cụ MCP	`task_delete`
Quyền cần có	`tasks.manage` — Chủ, Quản lý, Vận hành
Nhóm quyền	`automation:write`
Nhóm	Tác vụ và playbook
Hiện sẵn trong hồ sơ	—

Đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
`task_id`	string (uuid)	Có	Task id.
`expected_revision`	integer (1–∞)	Có	The revision you read (optimistic locking); a newer revision fails with revision_conflict.

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.

Thiết lập có phiên bản: gửi expected_revision (hoặc If-Match) bạn đã đọc, nếu không sẽ bị từ chối.

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 DELETE "https://reach-link-craft.lovable.app/api/public/v1/tasks/00000000-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H 'If-Match: "3"' \
  -H "Content-Type: application/json" \
  -d '{"expected_revision":1}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "task_delete",
    "arguments": {
      "task_id": "00000000-0000-4000-8000-000000000001",
      "expected_revision": 1,
      "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
`revision_required`	428	Không
`revision_conflict`	412	Không
`not_found`	404	Không

Về danh sách thao tác

Xoá một tác vụ

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP