Skip to main content
POST
Cancel a running or queued async job. Jobs that have already completed cannot be cancelled.
string
required
The unique job identifier (e.g., run_abc123).

Response

string
required
Unique job identifier.
string
required
Updated job status (cancelled).
string
required
ISO 8601 timestamp of cancellation.

Cancellation Behavior

  • Queued jobs: Immediately marked as cancelled, never started
  • Running jobs: Sent a cancellation signal; may take a moment to stop
  • Completed jobs: Cannot be cancelled (returns 400 error)

Example: Submit with Timeout and Cancel

Error Responses

See Also