POST /v1/jobs/{job_id}/cancel

Cancel a queued or running job.

Response: 200 OK

{
  "job_id": "job_<uuid>",
  "status": "cancelled",
  "already_terminal": false
}

Cancellation is best-effort. If the job is already running, the worker checks for cancellation between vendor calls and refunds the bill if it stops. already_terminal: true means the job was already done / failed / cancelled when you asked (no-op).

Curl

curl -sS -X POST "$BASE/v1/jobs/job_<uuid>/cancel" \
  -H "Authorization: Bearer $KEY"

Errors

If already_terminal is true, the job's final state stands (no error is returned, cancellation is a no-op).