---
title: "Create a logical splitter draft for mixed documents"
method: POST
path: "/splitters/logical"
tags: ["Splitters"]
---

# Create a logical splitter draft for mixed documents

`POST /splitters/logical`

## Request

- Base URL: `https://api.pdfparse.net/v1`
- URL: `https://api.pdfparse.net/v1/splitters/logical`
- Auth: HTTP bearer

Bind to one project inbox, or use a null sourceInboxId for project uploads. Publishing activates routing through project classification rules.

## Headers

- `Idempotency-Key` string: Scopes replay protection to the authenticated project, method, and route for 24 hours.

## Request body

- object
  - `name` string, required
  - `description` string, nullable
  - `config` object, required
    - `mode` 'logical', required
    - `sourceInboxId` string, nullable, required
    - `instructions` string, required
    - `sectionTypes` object[], required
      - `key` string, required
      - `name` string, required
      - `description` string
    - `routingMode` 'project_rules', required
    - `reviewUncertainBoundaries` boolean, required
    - `reviewUncertainDestinations` boolean, required
    - `boundaryConfidenceThreshold` integer
    - `maxSegments` integer

## Response `201`

Created

- object
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `mode` 'page_range' | 'logical', required
  - `status` 'draft' | 'published' | 'archived', required
  - `draft_revision` integer, required
  - `latest_version` integer, required
  - `config` union, required
    - object
      - `mode` 'page_range'
      - `overlap_policy` 'exclusive' | 'allowed'
      - `unassigned_policy` 'review' | 'ignore' | 'fallback'
      - `fallback_section_key` string
      - `max_segments` integer
      - `sections` object[], required
        - `section_key` string, required
        - `name` string, required
        - `description` string
        - `destination_table_id` string, required
        - `page_spans` object[], required
          - `start_page` integer, required
          - `end_page` integer, required
    - object
      - `mode` 'logical', required
      - `sourceInboxId` string, nullable, required
      - `instructions` string, required
      - `sectionTypes` object[], required
        - `key` string, required
        - `name` string, required
        - `description` string
      - `routingMode` 'project_rules', required
      - `reviewUncertainBoundaries` boolean, required
      - `reviewUncertainDestinations` boolean, required
      - `boundaryConfidenceThreshold` integer
      - `maxSegments` integer
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Workflow error

---

[API](https://skmtc.dev/pdfparse/apis/pdfparse-api.md) · [All operations](https://skmtc.dev/pdfparse/apis/pdfparse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfparse/apis/pdfparse-api/revisions/fb9f7c930c6d?raw)