Skip to main content

Case Merge & Split

Split a case into two cases or merge two cases into one. Restructure case boundaries when automatic grouping needs adjustment.

When the automatic case grouping does not match your needs, split a case into two partitions or merge two cases together.

These operations let you manually adjust case boundaries. Splitting divides a case by assigning each document to one of two partitions. Merging combines all documents from two cases into a single case. Both operations preserve linking edges and re-evaluate anomalies on the resulting cases.

When merging, case_key_b is resolved (set to resolved status) and its documents are moved into case_key_a. The merged case key is derived from case A.
POST/v1/cases/:key/split

Response

Response fields

case_astringCase key for the first partition (updated existing case).
case_bstringCase key for the second partition (new case).

Response

{
  "case_a": "a1b2c3d4e5f6a7b8",
  "case_b": "b2c3d4e5f6a7b8c9"
}
POST/v1/cases/merge

Response

Response fields

merged_case_keystringCase key of the resulting merged case (derived from case A).
document_countintegerTotal number of documents in the merged case.

Response

{
  "merged_case_key": "c3d4e5f6a7b8c9d0",
  "document_count": 7
}

Errors

Error responses

400bad_requestInvalid case key format.
401unauthorizedMissing or invalid API key.
404not_foundOne or both cases not found.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

List Cases
Case Operations