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}/cancelPath parameters
| Parameter | Type | Description |
|---|---|---|
jobId | string (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/:runIdcancels a synchronous run. - Already terminal (
completed,failed,timeout, or alreadycancelled) — this endpoint is idempotent. It returns200with 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
| Status | error | When |
|---|---|---|
404 | job_not_found | No 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"