---
title: "Split a case"
method: POST
path: "/v1/cases/{key}/split"
tags: ["Cases"]
---

# Split a case

`POST /v1/cases/{key}/split`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/cases/{key}/split`
- Auth: HTTP bearer

Split a case into two separate cases by partitioning its documents into two groups.

## Path parameters

- `key` string, uuid, required

## Request body

- object
  - `partition_b` string[], required: Document IDs that move out into the newly-created case (non-empty strict subset). Everything not listed stays on the existing case.
  - `partition_a` string[]: Informational only — the kept documents are derived as the complement of partition_b.

## Response `200`

Case split.

- object
  - `source_id` string, uuid, required: UUID of the existing case (retains the documents not listed in partition_b).
  - `new_case_id` string, uuid, required: UUID of the newly created case holding the partition_b documents.
  - `moved` integer, required: Count of documents moved into the new case.

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

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