Sign in

v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB
V2
Batches

Create Batch

Create a batch over a source directory and start processing asynchronously.

post/api/v2/batches

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

source_directory_idstring required

Directory whose files should be processed.

Example request

{
  "source_directory_id": "dir-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "config": {
    "job": {
      "configuration_id": "cfg-PARSE_AGENTIC"
    }
  }
}

Response

Successful Response

created_atstring date-time nullable

Creation datetime

updated_atstring date-time nullable

Update datetime

project_idstring required

Project this batch belongs to.

source_directory_idstring required

Directory being processed.

status'PENDING' | 'THROTTLED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

Current batch status.

Example response

{
  "config": {
    "job": {
      "configuration_id": "cfg-PARSE_AGENTIC"
    }
  },
  "results": [
    {
      "source_directory_file_id": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "job_reference": {
        "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
      }
    }
  ]
}