Intralinks Developer Portal

This API updates one or more existing folders with new settings.


Resource Location

POST /v1/services/workspaces/folders


Authorization Type

HTTP Cookie ssoGlobalSessionID


Request Parameters

Name Description Required Example
method Intralinks call method. Must be set to CREATE Yes method=CREATE
xml XML Document that contains the parameters for the call Yes
workspaceId Integer identifier of the target exchange Yes &workspaceId=123789

XML Body fields

Information about the folder you are creating needs to be submitted in an XML document with the following structure.

<folderCreateRequest>
  <folderCreate>
    <folder>
      <id></id>
      <name></name>
      <version></version>
      <indexingDisabled></indexingDisabled>
      <note></note>
    </folder>
    <folder>
      ...
    </folder>
  </folderCreate>
</folderCreateRequest>
Name Description Required Example
id folderId of the folder to update Yes <id>123456</id>
version Version of the folder. Used for optimistic locking Yes <version>2wd23ewd32</version>
name Name of the folder Yes <name>foo bar baz</name>
note Note associated with the folder No <note>this folder is for PDF's</note>
indexingDisabled Indicates whether search indexing should be turned off for this folder No <indexingDisabled>T</indexingDisabled>


Example Request

curl -k -X POST -b "ssoGlobalSessionID=SESSION_ID" -d "xml=XML_REQUEST" "https://test-api.intralinks.com/services/workspaces/folders method=UPDATE&client=YOUR_CLIENT_ID&workspaceId=WORKSPACE_ID"

Example XML

<folderUpdateRequest>
  <folder> 
   <id>13355087</id> 
   <name>index test rename</name> 
   <version>b6589fc6ab0dc82cf12099d1c2d40ab994e8410c</version> 
   <note>test update-xml validation</note> 
  </folder>
</folderUpdateRequest>

Example Response

<folderUpdateResponse> 
  <status> 
    <code>202</code> 
    <message>The entities have been updated</message> 
  </status> 
  <folderPartial> 
    <hasNote>T</hasNote> 
     <id>1234</id> 
     <name>Test Folder -1</name> 
     <indexNumber>1.1</indexNumber> 
     <orderNumber>1</orderNumber> 
     <version>b6589fc6ab0dc82cf12099d1c2d40ab994e8410c</version> 
  </folderPartial>
</folderUpdateResponse>