DELETE/api/v1/jobs/{job_id}
Delete Job
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
Request example
jsonjson
{
"tasks": [
{
"id": "T1",
"duration_days": 5
}
]
}Response example
jsonjson
{
"score": 92,
"grade": "A"
}Response fields from OpenAPI contract
This table is generated from the endpoint response schema in openapi.json.
| Field | Type | Required | Description |
|---|---|---|---|
| type | string | Required | Documentation URL for the code: https://bellatorsi.com/problems/<slug>. |
| title | string | Required | Short summary of the problem type. |
| status | integer | Required | HTTP status code. |
| detail | string | Required | What went wrong in this request. |
| instance | string | Optional | Request path. |
| code | string | Required | Stable UPPER_SNAKE machine code. |
| request_id | string | Optional | Same as the X-Request-ID header. |
Schema
json-schema
{
"$ref": "#/components/schemas/ProblemDetails"
}Authentication
- API key required
Reference details
- Operation ID
- jobs_delete
- Section
- Jobs
- Tags
- Jobs
Was this page helpful?
Your feedback helps us improve docs, reference pages, and Playground flows.
Topic: Delete Job · Page: /docs/api-reference/jobs_delete