Split a mixed PDF into its documents.

A mixed PDF is scanned for document boundaries, then split into child documents with page ranges and a confidence score for each boundary.

PDF received
test
quarterly-report.pdf
PDF · 18 pages · 4.2 MB
Accepted
Stored before any processing starts. Job job_parse_7ab2 was returned with HTTP 202.
Result
Waiting for the worker. Poll GET /v1/file-jobs/{id} until it finishes.
job
job_parse_7ab2
attempt
—
What it does

Real product states, not a promise.

A mixed PDF is scanned for document boundaries, then split into child documents with page ranges and a confidence score for each boundary.

  • Boundary detection with a confidence score
  • Each child is a stored PDF with its own file id
  • Page ranges reported explicitly
  • Distinct from POST /v1/pdf/split with known ranges
Input

One uploaded mixed PDF file_id

Output

Child PDF files with page ranges and confidence

Where it fits

Where it fits

01

Scanned intake batches

02

Mailroom digitisation

03

Bulk archive cleanup

API example

One durable request.

POST /v1/split-pdf. Use an idempotency key on create calls. The full request and response contract is in Flowyn Docs.

AcceptedClaimedAttemptedTerminal state
POSThttps://api.flowyn.dev/v1/split-pdf202
curl -X POST https://api.flowyn.dev/v1/split-pdf \
  -H "Authorization: Bearer flw_test_••••" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: split-001" \
  -d '{
    "file_id": "9c1e5b7a-2d4f-4a6b-8e3c-1f0a7d2b5c64"
  }'

Frequently asked questions

Where is the exact request contract for Intelligent PDF Splitter?
In Flowyn Docs and the OpenAPI document at https://api.flowyn.dev/openapi/v1.yaml. This page shows the request; the docs page lists every field, status value, error, and limit.
Is the operation durable?
Yes. The operation is stored before any work happens and remains a resource with state, attempts, and error context, not an ephemeral request log.
Do failures stay inspectable?
Yes. Every attempt is recorded. Repeated failures with the same fingerprint are also grouped into an Issue.

Build with Intelligent PDF Splitter.

Create a workspace, make your first call in the test environment, and inspect every attempt.