Splitters Migration | Extend Documentation

What You Get

Dedicated /splitters endpoints — No more type: "SPLITTER" filters
New GET /splitters/{id} endpoint — Retrieve a single splitter (not available in old API)
Typed SDK responses — splitter objects are typed, no casting needed
Simpler config — No more type field required

The old /processors endpoint is still supported in this API version for backward compatibility. You can migrate incrementally.

Quick Start: Common Patterns

Creating a Splitter

TypeScript

Python

Java

Before (2025-04-21)

const processor = await client.processor.create({
  name: "Invoice Packet Splitter",
  type: "SPLITTER",
  config: { type: "SPLITTER", splitClassifications: [...] }
});

After (2026-02-09)

const splitter = await client.splitters.create({
  name: "Invoice Packet Splitter",
  config: { splitClassifications: [...] }
});

Retrieving a Splitter (New!)

TypeScript

Python

Java

const splitter = await client.splitters.retrieve("spl_abc123");
console.log(splitter.draftVersion.config);

Listing Splitters

TypeScript

Python

Java

Before

const processors = await client.processor.list({ type: "SPLITTER" });

After

const splitters = await client.splitters.list();

Publishing a Version

TypeScript

Python

Java

Before

const version = await client.processorVersion.create("dp_abc123", { releaseType: "minor" });

After

const version = await client.splitterVersions.create("spl_abc123", { releaseType: "minor" });

Endpoint Changes Summary

Old Endpoint	New Endpoint
`POST /processors` (type: SPLITTER)	`POST /splitters`
`GET /processors?type=SPLITTER`	`GET /splitters`
(not available)	`GET /splitters/{id}` (new!)
`POST /processors/{id}`	`POST /splitters/{id}`
`POST /processors/{id}/publish`	`POST /splitters/{splitterId}/versions`
`GET /processors/{id}/versions`	`GET /splitters/{splitterId}/versions`
`GET /processors/{id}/versions/{versionId}`	`GET /splitters/{splitterId}/versions/{versionId}`

Request Changes

Old	New	Notes
`type: "SPLITTER"`	(removed)	Implicit from endpoint
`cloneProcessorId`	`cloneSplitterId`	Renamed
`config.type: "SPLITTER"`	(removed)	Implicit
`config.parser`	`config.parseConfig`	Renamed
`config.baseProcessor`	`config.baseProcessor`	No change (optional)

cloneSplitterId and config are mutually exclusive. You can either clone an existing splitter or provide a config, but not both. The API will return a validation error if both are provided.

Response Changes

Response shape changes: Single object responses are now returned directly (no wrapper key), and list responses use { "object": "list", "data": [...] } format. See Simplified Response Shapes for details.

Old	New
`success: true`	(removed)
`{ "splitter": {...} }`	`{...}` (object returned directly)
`processors`	`splitters`
`processorVersion`	`splitterVersion`
`versions`	`splitterVersions`
`draftVersion.processorId`	`draftVersion.splitterId`
List includes `versions[]`	(removed) — Use versions endpoint

SDK Method Reference

Old Method	New Method
`client.processor.create()`	`client.splitters.create()`
`client.processor.list()`	`client.splitters.list()`
`client.processor.update()`	`client.splitters.update()`
—	`client.splitters.retrieve()` (new!)
`client.processorVersion.create()`	`client.splitterVersions.create()`
`client.processorVersion.list()`	`client.splitterVersions.list()`
`client.processorVersion.get()`	`client.splitterVersions.retrieve()`

Detailed Schema Changes

Splitter Schema

Property	Old (Processor)	New (Splitter)	Change
`object`	`"document_processor"`	`"splitter"`	Value changed
`id`	Required `string`	Required `string`	No change
`name`	Required	Required	No change
`type`	Required `"SPLITTER"`	—	Removed
`draftVersion`	`ProcessorVersion`	`SplitterVersion`	No change
`createdAt`	Required	Required	No change
`updatedAt`	Required	Required	No change

SplitterSummary Schema (List Response)

Property	Old	New	Change
`object`	`"document_processor"`	`"splitter"`	Value changed
`type`	Required	—	Removed
`versions`	Required array	—	Removed

SplitterVersion Schema

Property	Old (ProcessorVersion)	New (SplitterVersion)	Change
`object`	`"document_processor_version"`	`"splitter_version"`	Value changed
`id`	Required `string`	Required `string`	No change
`processorId`	Required	—	Renamed to `splitterId`
`splitterId`	—	Required	New
`processorName`	Optional	—	Removed
`processorType`	Required	—	Removed
`version`	Required	Required	No change
`description`	Optional	Optional	No change
`config`	`SplitterConfig`	`SplitConfig`	No change
`createdAt`	Required	Required	No change
`updatedAt`	Required	—	Removed

SplitConfig Schema

Property	Old (SplitterConfig)	New (SplitConfig)	Change
`type`	Required `"SPLITTER"`	—	Removed
`baseProcessor`	Optional	Optional	No change
`splitClassifications`	Required	Required	No change
`parser`	Optional	—	Renamed
`parseConfig`	—	Optional	New (replaces `parser`)

Need Help?

If you encounter any issues while migrating, please contact our support team at support@extend.app.

Migration Guides

Guide	Migrating From	Migrating To
Overview	—	What’s new and how to upgrade
Extract Runs	`/processor_runs`	`/extract_runs` + `/extract`
Classify Runs	`/processor_runs`	`/classify_runs` + `/classify`
Split Runs	`/processor_runs`	`/split_runs` + `/split`
Parse Runs	`/parse`, `/parse/async`	`/parse_runs` + `/parse`
Edit Runs	`/edit`, `/edit/async`	`/edit_runs` + `/edit`
Extractors	`/processors`	`/extractors`
Classifiers	`/processors`	`/classifiers`
Splitters	`/processors`	`/splitters`
Files	`/files`	`/files` (breaking changes)
Evaluation Sets	evaluation endpoints	Updated evaluation endpoints
Workflow Runs	`/workflow_runs`	`/workflow_runs` (breaking changes)
Webhooks	`processor_run.*` events	`extract_run.`, `classify_run.`, etc.