Cancel Parse Job

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
JOB_ID = "prs_8f14e45fceea167a5a36dedd4bea2543"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
response = requests.delete(
    f"{BASE_URL}/v3/parse/jobs/{JOB_ID}",
    headers=headers,
    timeout=30.0
)
if response.status_code == 200:
    job = response.json()
    print(f"Job {job['job_id']} is {job['status']}")
else:
    print(f"Error: {response.status_code}")

{
  "job_id": "prs_8f14e45fceea167a5a36dedd4bea2543",
  "type": "document",
  "status": "cancelled",
  "created_at": "2026-10-01T15:04:05Z",
  "file": {
    "name": "report.pdf",
    "type": "pdf",
    "pages": 12
  },
  "options": {
    "processing_type": "advanced"
  },
  "chunker_version": null,
  "usage": {
    "pages_basic": 0,
    "pages_advanced": 0,
    "credits": 0
  },
  "chunk_count": null,
  "chunks": null,
  "result_url": null,
  "result_expires_at": null,
  "error": null,
  "completed_at": "2026-10-01T15:04:20Z"
}

Stops a running parse job, or deletes a finished job's result before it expires. A cancelled job is not billed.

Path parameters

job_idstringRequired

Response

The job after cancellation.

job_idstring

typeenum

Allowed values:

statusenum

Allowed values:

created_atstringformat: "date-time"

fileobjectOptional

optionsobjectOptional

The options the job ran with. Credentials are never returned.

chunker_versionstring or nullOptional

usageobjectOptional

What this job was billed, at the same rates as indexing. Documents bill per page. Spreadsheets bill no pages: their credits come from the sheet text and any described images.

chunk_countinteger or nullOptional

chunkslist of objects or nullOptional

The chunks, in order, when the result is 1 MB or smaller. Larger results are returned only through result_url.

result_urlstring or nullOptional

result_expires_atstring or nullOptionalformat: "date-time"

errorobject or nullOptional

Why the job failed. Present when status is failed. A failed job is not billed.

completed_atstring or nullOptionalformat: "date-time"

Errors

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Response

Errors