# Split Document

Intelligently split a document into multiple files from Apex.

> Kind: Apex method · Updated: 2026-07-01

## Signature

```apex
global static void splitDocument(
  List<Types.SplitDocumentPayload> payloads,
  String runAs
)
```

### Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| payloads | List&lt;<a href="#/apex-type-split-document-payload">Types.SplitDocumentPayload</a>&gt; | required | List of Types.SplitDocumentPayload — one entry per document to split. |
| runAs | String | optional | Username to attribute the operation to; usually a static value such as integrationUser. |

## Return Type

void

## Example

```apex
cldfs.Resource destination = new cldfs.Resource(
    '006dL000005H4srQAC',
    null,
    null,
    'salesforce',
    null
);
String context = '006dL000005H4srQAC'; 
List<cldfs.Types.SplitDocumentPayload> payloads = new List<cldfs.Types.SplitDocumentPayload>{
    new cldfs.Types.SplitDocumentPayload(
        '069dL00000B4C7WQAV',
        null,
        'salesforce',
        destination,
        null,
        context
    )
};
cldfs.Client.splitDocument(payloads, 'integrationUser');
```

> **Testing** — Use ClientFactory with default mock values to get coverage without callouts. See How to get test coverage of code that uses Client methods.