Jobs and downloads

Cancel a job

Review #82 / D45 — cooperative job cancellation.

Semantics:

  • status=queued → flip to "cancelled" immediately; worker will skip it when picked up.
  • status=running → set cancel_requested=True; long-running compute steps that check the flag will exit early. Status is not flipped here because the worker owns the lifecycle.
  • status=complete | failed | cancelled → 409 Conflict (terminal state). Idempotent re-cancel is intentionally rejected so the UI can distinguish "I cancelled this" from "this already finished".

Workers can read the flag via jobs.get(job_id, {}).get('cancel_requested') at checkpoints.

delete/api/jobs/{job_id}

Request

  • Base URL: https://epw.tools
  • URL: https://epw.tools/api/jobs/{job_id}
  • Auth: API key in header X-API-Key

Path parameters

job_idstring required

Query parameters

keystring nullable
tokenstring nullable

Headers

X-API-Keystring nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.