GetFolders2 API

Returns the list of direct subfolders of the specified folder in short form, applying the system's configured maximum folder display count limit. This API is used by the infoRouter UI folder panel to avoid overloading the interface with extremely large folder lists.

Endpoint

/srv.asmx/GetFolders2

Methods

GET /srv.asmx/GetFolders2?authenticationTicket=...&Path=...
POST /srv.asmx/GetFolders2 (form data)
SOAP Action: http://tempuri.org/GetFolders2

Parameters

Parameter	Type	Required	Description
`authenticationTicket`	string	Yes	Authentication ticket obtained from `AuthenticateUser`.
`Path`	string	Yes	Full infoRouter path to the parent folder (e.g. `/Finance`).

Response

Success Response

<response success="true">
  <folder id="456" name="Reports" />
  <folder id="457" name="Invoices" />
  <folder id="458" name="Contracts" />
</response>

Error Response

<response error="Folder not found." />

Required Permissions

The calling user must have read permission on the parent folder. Only subfolders the user has access to are returned.

Example

GET Request

GET /srv.asmx/GetFolders2
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &Path=/Finance
HTTP/1.1

POST Request

POST /srv.asmx/GetFolders2 HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&Path=/Finance

SOAP Request

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:GetFolders2>
      <tns:authenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:authenticationTicket>
      <tns:Path>/Finance</tns:Path>
    </tns:GetFolders2>
  </soap:Body>
</soap:Envelope>

Notes

The maximum number of returned folders is controlled by the MaximumDisplayFolderCount UI setting in infoRouter's system configuration.
If a folder has more subfolders than the limit allows, only the first N folders (up to the limit) are returned.
For unlimited folder listing, use GetFolders1.
This API is primarily used by the infoRouter web UI folder tree panel.
For full property details per folder, use GetFolders instead.

GetFolders1 - Get subfolders with no count limit
GetFolders - Get subfolders with full properties
GetFoldersByPage - Get paged subfolders with filter

Error Codes

Error	Description
`[900] Authentication failed`	Invalid or missing authentication ticket.
`[901] Session expired or Invalid ticket`	The ticket has expired or does not exist.
Folder not found	The specified path does not resolve to an existing folder.
Access denied	The user does not have read permission on the folder.
`SystemError:...`	An unexpected server-side error occurred.

For detailed documentation visit: https://support.inforouter.com/api-docs/GetFolders2