---
title: "Cancel Job"
method: POST
path: "/api/v1/jobs/{job_id}/cancel"
tags: ["Jobs"]
---

# Cancel Job

`POST /api/v1/jobs/{job_id}/cancel`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/jobs/{job_id}/cancel`
- Auth: none declared

Cancel a queued or processing job.

**Cancellation Rules:**
- Only queued or processing jobs can be cancelled
- Completed, failed, or already cancelled jobs cannot be cancelled
- Celery task is revoked (terminated) if currently executing

**Use Cases:**
- User-initiated cancellation
- Timeout or resource constraints
- Superseded by newer job submission

## Path parameters

- `job_id` string, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable
- `x-bellator-internal-dispatch` string, nullable

## Response `200`

Success - Job cancelled

- object

## Other responses

- `400`: Bad Request - Job cannot be cancelled
- `404`: Not Found - Job does not exist
- `422`: Validation Error
- `429`: Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)