Jobs resources

Post Jobs

post

accept a document for processing

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

uploadfilestring · binaryRequired

doctypeany ofOptionalDefault: ""

stringOptional

or

nullOptional

maxsizeany ofOptionalDefault: 5000

integerOptional

or

nullOptional

usetagsany ofOptionalDefault: []

stringOptional

or

nullOptional

maxtagsany ofOptionalDefault: 1

integerOptional

or

nullOptional

callbackurlany ofOptional

stringOptional

or

nullOptional

process_imagesany ofOptionalDefault: false

booleanOptional

or

nullOptional

pdf_parsing_backendany ofOptionalDefault: pymupdf

stringOptional

or

nullOptional

enable_ocrany ofOptionalDefault: false

booleanOptional

or

nullOptional

ocr_backendany ofOptional

stringOptional

or

nullOptional

force_full_page_ocrany ofOptionalDefault: false

booleanOptional

or

nullOptional

Responses

200

Successful Response

application/json

successbooleanRequired

jobidany ofRequired

stringOptional

or

nullOptional

documentidany ofRequired

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

post

/jobs

HTTPcURLJavaScriptPython

POST /jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 222

{
  "uploadfile": "binary",
  "doctype": "",
  "maxsize": 5000,
  "usetags": "[]",
  "maxtags": 1,
  "callbackurl": "text",
  "process_images": false,
  "pdf_parsing_backend": "pymupdf",
  "enable_ocr": false,
  "ocr_backend": "text",
  "force_full_page_ocr": false
}

{
  "success": true,
  "jobid": "text",
  "documentid": "text"
}

Get Jobs

get

return a list of all jobs

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful Response

application/json

404

Not found

get

/jobs/

HTTPcURLJavaScriptPython

GET /jobs/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "ip": "text",
      "documentid": "text",
      "status": "NEW",
      "created": "2026-03-17T21:13:58.022Z",
      "updated": "2026-03-17T21:13:58.022Z",
      "completed": "2026-03-17T21:13:58.022Z",
      "maxsize": 1,
      "timeit": 1,
      "callbackurl": "text",
      "progress": 1
    }
  ]
}

Get Job

get

return the details of one job

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

jobidstringRequired

Responses

200

Successful Response

application/json

idstringRequired

ipstringRequired

documentidstringRequired

statusstring · enumRequiredPossible values:

createdstring · date-timeRequired

updatedstring · date-timeRequired

completedany ofRequired

string · date-timeOptional

or

nullOptional

maxsizeintegerRequired

timeitany ofRequired

integerOptional

or

nullOptional

callbackurlany ofRequired

stringOptional

or

nullOptional

progressintegerRequired

404

Not found

422

Validation Error

application/json

get

/jobs/{jobid}

HTTPcURLJavaScriptPython

GET /jobs/{jobid} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "ip": "text",
  "documentid": "text",
  "status": "NEW",
  "created": "2026-03-17T21:13:58.022Z",
  "updated": "2026-03-17T21:13:58.022Z",
  "completed": "2026-03-17T21:13:58.022Z",
  "maxsize": 1,
  "timeit": 1,
  "callbackurl": "text",
  "progress": 1
}

Delete Job

delete

delete a job and all related documents

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

jobidstringRequired

Responses

204

Successful Response

404

Not found

422

Validation Error

application/json

delete

/jobs/{jobid}

HTTPcURLJavaScriptPython

DELETE /jobs/{jobid} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Cancel Job

patch

cancel a job

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

jobidstringRequired

Body

application/json

statusstring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

idstringRequired

ipstringRequired

documentidstringRequired

statusstring · enumRequiredPossible values:

createdstring · date-timeRequired

updatedstring · date-timeRequired

completedany ofRequired

string · date-timeOptional

or

nullOptional

maxsizeintegerRequired

timeitany ofRequired

integerOptional

or

nullOptional

callbackurlany ofRequired

stringOptional

or

nullOptional

progressintegerRequired

404

Not found

422

Validation Error

application/json

patch

/jobs/{jobid}

HTTPcURLJavaScriptPython

PATCH /jobs/{jobid} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "status": "NEW"
}

{
  "id": "text",
  "ip": "text",
  "documentid": "text",
  "status": "NEW",
  "created": "2026-03-17T21:13:58.022Z",
  "updated": "2026-03-17T21:13:58.022Z",
  "completed": "2026-03-17T21:13:58.022Z",
  "maxsize": 1,
  "timeit": 1,
  "callbackurl": "text",
  "progress": 1
}