Box Connector 24.2

# Insert Files into Box

The connector's `insert` fetch action inserts files into the Box repository. To use the insert action, you must construct some XML that specifies where to add each file, and the information to insert. URL encode the XML and add it to the action as the value of the `insertXML` action parameter. For example:

    http://host:port/action=Fetch
                              &FetchAction=Insert
                              &ConfigSection=MyTask
                              &InsertXML=[URL encoded XML]

The following table describes the properties that you must set in the `insertXML` provided to the insert action:

Property | Description | Required
--- | --- | ---
`ENTERPRISE_USER_LOGIN` | The login name of the user account to add the file to. If you are inserting files into Box Enterprise, you can set this property or the `UID` property. You can only use this property with Box Enterprise. | No
`PATH` | The desired destination path of the file in the Box repository, relative to the top-level accessible folder. | Yes
`UID` | The user ID of the Box user. | Yes, unless you are inserting files into Box Enterprise and have set `ENTERPRISE_USER_LOGIN` instead.

For example:

    <insertXML>
       <insert>
         <property name="PATH" value="/folder/file.txt"/>
         <property name="UID" value="..."/>
         <file>
           <type>content</type>
           <content>SGVsbG8gV29ybGQNCg==</content>
         </file>
       </insert>
    </insertXML>

The `<file>` element contains the file to insert into the repository. You can supply the path to a file, base-64 encoded content, or choose to send the file to the connector's data port. For more information about the `insert` fetch action and the XML elements you can use in the `insertXML` parameter, refer to the Box Connector Reference.

Copyright 2024 Open Text
Version 24.2 | Last updated March 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Box Connector 24.2

Topic Title: Insert Files into Box