---
title: "Delete Job"
method: DELETE
path: "/api/v1/jobs/{job_id}"
tags: ["Jobs"]
---

# Delete Job

`DELETE /api/v1/jobs/{job_id}`

## 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}`
- Auth: none declared

Delete a completed, failed, or cancelled job result.

**Deletion Rules:**
- Only completed, failed, or cancelled jobs can be deleted
- Queued or processing jobs cannot be deleted (return 409 Conflict)
- Job data is permanently removed from Redis

**Use Cases:**
- Cleanup after retrieving results
- Remove sensitive job data
- Free up storage space

## Path parameters

- `job_id` string, required

## Headers

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

## Response `204`

No Content - Job deleted successfully

## Other responses

- `404`: Not Found - Job does not exist
- `409`: Conflict - Job is still queued or processing
- `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)