v3

latestOpenAPI 3.1.02026-07-3153169140.2 KB
jobs

Cancel Job

Cancel an in-flight job.

Routes a CancelRequest through the scheduler (the single writer of jobs / computation_node) and awaits the outcome — never writes the DB directly. The scheduler flips the job + its non-terminal nodes to cancelled, releases the concurrency lease, and interrupts in-flight worker executions.

Idempotent: cancelling an already-cancelled job is a 200 no-op; a completed / failed job is a 409 (you can't cancel a finished job); an unknown job — or one belonging to another org — is a 404.

post/v1/jobs/{job_id}/cancel

Path parameters

job_idstring uuid required

Response

Successful Response

job_typestring required
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required
progressnumber nullable
created_atstring date-time required
updated_atstring date-time required
metrics_urlstring required
result_urlstring required
artifacts_urlstring required