POST /api/v1/tasks/{id}/cancel

POST http://localhost:8080/api/v1/tasks/{id}/cancel

X-API-Key: sk_test_123456

{
  "reason": "Stopped by user"
}

{
  "success": true,
  "message": "Task cancelled successfully"
}

{
  "success": false,
  "message": "Task is already in terminal state: COMPLETED",
  "status": "COMPLETED"
}

{ "error": "Task not found" }

{ "error": "Unauthorized" }

{ "error": "Forbidden" }

curl -X POST "http://localhost:8080/api/v1/tasks/${TASK_ID}/cancel" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"user request"}'

import httpx

resp = httpx.post(
    f"http://localhost:8080/api/v1/tasks/{task_id}/cancel",
    headers={"X-API-Key": api_key},
    json={"reason": "cleanup"}
)
print(resp.status_code, resp.json())

await axios.post(
  `http://localhost:8080/api/v1/tasks/${taskId}/cancel`,
  { reason: "not needed" },
  { headers: { "X-API-Key": apiKey } }
);