---
title: "ADE Split"
method: POST
path: "/v1/ade/split"
tags: ["Tools"]
---

# ADE Split

`POST /v1/ade/split`

Split classification for documents.

This endpoint classifies document sections
    based on markdown content and split options.

For EU users, use this endpoint:


    `https://api.va.eu-west-1.landing.ai/v1/ade/split`.

## Request body

- union — Request model for split classification endpoint.
  - object
    - `markdown` string, nullable, required — Markdown content to split.
    - `markdownUrl` string, nullable — The URL to the Markdown file to split.
    - `split_class` SplitClass[], required — List of split classification options/configuration. Can be provided as JSON string in form data.
      - `name` string, required — Name of the split classification type
      - `description` string, nullable — Detailed description of what this split type represents
      - `identifier` string, nullable — Identifier to partition/group the splits by
    - `model` string, nullable — Model version to use for split classification. Defaults to the latest version.
  - object
    - `markdown` string, nullable — Markdown content to split.
    - `markdownUrl` string, nullable, required — The URL to the Markdown file to split.
    - `split_class` SplitClass[], required — List of split classification options/configuration. Can be provided as JSON string in form data.
      - `name` string, required — Name of the split classification type
      - `description` string, nullable — Detailed description of what this split type represents
      - `identifier` string, nullable — Identifier to partition/group the splits by
    - `model` string, nullable — Model version to use for split classification. Defaults to the latest version.

## Response `200`

Successful Response

- SplitResponse — Response model for split classification endpoint.
  - `splits` SplitData[], required
    - `classification` string, required
    - `identifier` string, nullable, required
    - `pages` integer[], required
    - `markdowns` string[], required
  - `metadata` SplitMetadata, required — Metadata for split classification response.
    - `filename` string, required
    - `org_id` string, nullable — Organization ID
    - `page_count` integer, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string — Inference history job ID
    - `version` string, nullable — Model version used for split classification

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-13** `e8084df42cc1` — 3 info
  - added `subschema #1, subschema #2` to the request body `oneOf` list (media type: application/json)
  - added `subschema #1, subschema #2` to the request body `oneOf` list (media type: multipart/form-data)
  - the request property `markdown` became nullable (media type: multipart/form-data)
- **2026-02-13** `73d13502c1d0` — 3 breaking, 3 info
  - request property `markdown` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `markdownUrl` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `model` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - added the media type `application/json` to the request body
  - …2 more
- **2026-02-13** `62ce42134d4b` — 1 info
  - the endpoint scheme security `Basic Auth` was removed from the API
- **2026-02-13** `eeb4eb7952ab` — 1 info
  - the endpoint scheme security `Basic Auth` was added to the API
- **2025-12-04** `4c3b46448454` — 1 breaking, 1 warning
  - added the new required request property `split_class`
  - removed the request property `options`

[Full history](https://skmtc.dev/landing-ai/apis/ade-api/changes/v1/ade/split/post.md)

---

[API](https://skmtc.dev/landing-ai/apis/ade-api.md) · [All operations](https://skmtc.dev/landing-ai/apis/ade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/landing-ai/ade-api/revisions/e8084df42cc1/schema)