---
title: "Create Split Job"
method: POST
path: "/api/v1/beta/split/jobs"
tags: ["Beta", "Split"]
---

# Create Split Job

`POST /api/v1/beta/split/jobs`

Create a document split job.

## Query parameters

- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Request body

- SplitCreateRequest — Beta create request — accepts legacy document_input and flat formats.
  - `document_input` SplitDocumentInput, required — Document input specification for beta API.
    - `type` string, required — Type of document input. Valid values are: file_id
    - `value` string, required — Document identifier.
  - `configuration` SplitConfiguration — Split configuration with categories and splitting strategy.
    - `categories` SplitCategory[], required — Categories to split documents into.
      - `name` string, required — Name of the category.
      - `description` string, nullable — Optional description of what content belongs in this category.
    - `splitting_strategy` SplitStrategy — Configuration for how to split the document.
      - `allow_uncategorized` 'include' | 'forbid' | 'omit' — Controls handling of pages that don't match any category. 'include': pages can be grouped as 'uncategorized' and included in results. 'forbid': all pages must be assigned to a defined category. 'omit': pages can be classified as 'uncategorized' but are excluded from results.
  - `configuration_id` string, nullable — Saved split configuration ID.

## Response `201`

Successful Response

- SplitJobResponse — Beta response — uses nested document_input object.
  - `id` string, required — Unique identifier for the split job.
  - `created_at` string, date-time, nullable — Creation datetime
  - `updated_at` string, date-time, nullable — Update datetime
  - `project_id` string, required — Project ID this job belongs to.
  - `user_id` string, required — User ID who created this job.
  - `configuration_id` string, nullable — Split configuration ID used for this job.
  - `document_input` SplitDocumentInput, required — Document input specification for beta API.
    - `type` string, required — Type of document input. Valid values are: file_id
    - `value` string, required — Document identifier.
  - `categories` SplitCategory[], required — Categories used for splitting.
    - `name` string, required — Name of the category.
    - `description` string, nullable — Optional description of what content belongs in this category.
  - `status` string, required — Current status of the job. Valid values are: pending, processing, completed, failed, cancelled.
  - `result` SplitResultResponse — Result of a completed split job.
    - `segments` SplitSegmentResponse[], required — List of document segments.
      - `category` string, required — Category name this split belongs to.
      - `pages` integer[], required — 1-indexed page numbers in this split.
      - `confidence_category` string, required — Categorical confidence level. Valid values are: high, medium, low.
  - `error_message` string, nullable — Error message if the job failed.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/revisions/b17341164de9/schema)