Skip to content
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

json
json
{
  "tasks": [
    {
      "id": "T1",
      "duration_days": 5
    }
  ]
}

Response example

json
json
{
  "score": 92,
  "grade": "A"
}

Response fields from OpenAPI contract

This table is generated from the endpoint response schema in openapi.json.

FieldTypeRequiredDescription
typestringRequiredDocumentation URL for the code: https://bellatorsi.com/problems/<slug>.
titlestringRequiredShort summary of the problem type.
statusintegerRequiredHTTP status code.
detailstringRequiredWhat went wrong in this request.
instancestringOptionalRequest path.
codestringRequiredStable UPPER_SNAKE machine code.
request_idstringOptionalSame 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

TermsPrivacyContact

Schedule analysis guidance. Not legal advice. You remain responsible for contract and agency compliance.