Skip to main content

​
Authentication & Scope

Requires the sessions-write ability.

​
Overview

This endpoint creates one session per uploaded file, with each session containing the corresponding document. This is the most efficient way to process multiple documents.
Enable auto_extract to automatically start extraction after document parsing completes. This eliminates the need to call the execute endpoint separately.

​
Request

​
Path Parameters

​
Body Parameters

File keys are obtained from the signed URL upload process. Each file creates a separate session.

​
Response

201 Created – Array of created sessions.
Session names initially show “Pending…” and are automatically updated to the document filename once processing begins.

​
Auto-Extract Workflow

When auto_extract: true:
  1. Sessions are created with uploaded documents
  2. Documents are automatically parsed into searchable chunks
  3. Once parsing completes, extraction starts automatically
  4. Results appear in the session’s results endpoint
With auto-extract enabled, you don’t need to call the Batch Execute endpoint. Doing so would create duplicate extraction jobs.

​
Example: Complete Workflow

1

Upload files and get keys

Use signed URLs to upload your documents first.
2

Batch create with auto-extract

3

Poll for results

Check each session’s results endpoint until status is completed.

​
Error Responses