Sign in

v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB
Classifier
Beta
Classifier

Create Classify Job

Create a classify job. Experimental: not production-ready and subject to change.

post/api/v1/classifier/jobs

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

mode'FAST' | 'MULTIMODAL'

Supported classification execution modes.

file_idsstring[] required

The IDs of the files to classify

Example request

{
  "rules": [
    {
      "type": "invoice",
      "description": "contains invoice number, line items, and total amount"
    }
  ],
  "webhook_configurations": [
    {
      "webhook_events": [
        "parse.success",
        "parse.error"
      ],
      "webhook_output_format": "json"
    }
  ]
}

Response

Successful Response

status'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED' required

Enum for representing the status of a job

effective_atstring date-time
job_record_idstring nullable

The job record ID associated with this status, if any.

error_messagestring nullable

Error message for the latest job attempt, if any.

idstring uuid required

Unique identifier

created_atstring date-time nullable

Creation datetime

updated_atstring date-time nullable

Update datetime

user_idstring required

The ID of the user

project_idstring uuid required

The ID of the project

mode'FAST' | 'MULTIMODAL'

Supported classification execution modes.

Example response

{
  "rules": [
    {
      "type": "invoice",
      "description": "contains invoice number, line items, and total amount"
    }
  ]
}