---
schema_version: "1"
id: 482a6bcbc21d325add773f54f2169846d6e62bfff4a933627f21b09e1fc64bd0
title: Split Documents
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/connect_resources_split_documents.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_resources_split_documents.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9265fd66aa6aecd779a3278163a1315907ae1b9edbfd75ed3a9893fefd23965f
description: Split a document and attach one or more pages from the transformed document to Salesforce records.
---
# Split Documents

Split a document and attach one or more pages from the transformed document to Salesforce records.

For example, suppose you receive a fax containing multiple patients' documents in a single scanned copy. As needed, separate the document pages and attach the split documents to the patient's record.

## Resource

/connect/document-automation/contentDocuments/${contentDocumentId}/linkedObjects/${linkedObjectId}

## Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org, and replace {XX.X} with the API version.

https://{yourInstance}.salesforce.com/services/data/v{XX.X}/connect​/document-automation/contentDocuments/0ioRM0000004CqTYAU/linkedObjects/0OxRM0000004CqTYAU

## Available Version

55.0

## Requires Chatter

No

## HTTP Methods

POST

## Request Parameters for POST

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| contentDocumentID | String | The ID of the content document to be split. | Required | 55.0 |
| linkedObjectID | String | The ID of the linked object with which the split document must be associated. This is the ID of the DocumentChecklistItem object for Salesforce. | Required | 55.0 |

## Request Body for POST

### JSON Example

{
    "pageSpecificationList": { 
        "pageSpecifications": \[
            {
                "page":1,
                "rotation":0,
                "addToTargetFile":"true"
            },
            {
                "page":2,
                "rotation":0,
                "addToTargetFile":"true"
            }
        \]
    },
    "linkedObjectFieldsMap" : {
        "linkedObjectFields" : {"ReceivedDocumentId" : "0ioxx00000000ODAAY"}
    },
    "isOcrRequested" : true
}

### Properties

<table class="featureTable sort_table" summary="">
            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d479700e214">Name</th>
                <th class="featureTableHeader vertical-align-top " id="d479700e216">Type</th>
                <th class="featureTableHeader vertical-align-top " id="d479700e218">Description</th>
                <th class="featureTableHeader vertical-align-top " id="d479700e220">Required or Optional</th>
                <th class="featureTableHeader vertical-align-top " id="d479700e222">Available Version</th>
              </tr>
            </thead>
            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d479700e214" data-title="Name"><samp class="codeph nolang">isOcrRequested</samp></td>
                <td class="entry" headers="d479700e216" data-title="Type">Boolean</td>
                <td class="entry" headers="d479700e218" data-title="Description">Indicates whether OCR is required to process the content document (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).<p class="p">By default, OCR is performed on the first five pages of
                    the content document.</p>
                  <p class="p">Note: Set this field value to true to perform OCR on
                    all the pages of a content document that contains more than five
                    pages.</p>
                </td>
                <td class="entry" headers="d479700e220" data-title="Required or Optional">Optional</td>
                <td class="entry" headers="d479700e222" data-title="Available Version">55.0</td>
              </tr>
              <tr>
                <td class="entry" headers="d479700e214" data-title="Name"><samp class="codeph nolang">linkedObjectFieldsMap</samp></td>

                <td class="entry" headers="d479700e216" data-title="Type">Map&lt;String, String&gt;</td>

                <td class="entry" headers="d479700e218" data-title="Description">Represents the map that contains the linked object
                  fields. For example, the linked object is the Document
                  Checklist Item for Salesforce.</td>

                <td class="entry" headers="d479700e220" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d479700e222" data-title="Available Version">55.0</td>

              </tr>
              <tr>
                <td class="entry" headers="d479700e214" data-title="Name"><samp class="codeph nolang">pageSpecificationList</samp></td>
                <td class="entry" headers="d479700e216" data-title="Type">
                  <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_requests_page_specification_input.htm" title="Input representation of the page specification list.">Page
                    Specification List Input</a>[]
                </td>
                <td class="entry" headers="d479700e218" data-title="Description">The page specifications list representation.</td>
                <td class="entry" headers="d479700e220" data-title="Required or Optional">Required</td>
                <td class="entry" headers="d479700e222" data-title="Available Version">55.0</td>
              </tr>
              <tr>
                <td class="entry" headers="d479700e214" data-title="Name"><samp class="codeph nolang">targetFileName</samp></td>
                <td class="entry" headers="d479700e216" data-title="Type">String</td>
                <td class="entry" headers="d479700e218" data-title="Description">The name of the target file that is created from the split document.</td>
                <td class="entry" headers="d479700e220" data-title="Required or Optional">Optional</td>
                <td class="entry" headers="d479700e222" data-title="Available Version">55.0</td>
              </tr>
            </tbody>
          </table>

## Response Body for POST

[Document Management Result](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_responses_document_management_result.htm "Output representation of the document split request.")