Elizon Docs
API Reference

Cancel team job

POST /api/v1/team-jobs/:jobId/cancel — cancel an async team run before it finishes.

Cancels an async job before it finishes.

POST /api/v1/team-jobs/{jobId}/cancel

Path parameters

ParameterTypeDescription
jobIdstring (UUID)The job to cancel.

Behaviour

  • Queued job — removed from the queue before it ever starts running.
  • Running job — the in-flight team run is cancelled the same way DELETE /teams/:teamId/runs/:runId cancels a synchronous run.
  • Already terminal (completed, failed, timeout, or already cancelled) — this endpoint is idempotent. It returns 200 with the job's actual current status, unchanged. Cancelling a finished job is not an error.

Response

200 OK

{ "jobId": "9c4e2a1b-...", "status": "cancelled" }

Or, if the job had already reached a terminal state before the cancel request arrived:

{ "jobId": "9c4e2a1b-...", "status": "completed" }

Errors

StatuserrorWhen
404job_not_foundNo job with that ID exists for your organization or your key's project. A job of another tenant is also 404, never 403.

Example

curl -X POST https://api.elizon.ai/api/v1/team-jobs/9c4e2a1b-.../cancel \
  -H "X-API-Key: elz_your_key_here"