Returns all folders and subfolders, starting at the folder path. The getFolders response returns a maximum of 100,000 folders.
A folder enables you to organize subfolders and assets. All folder and asset names must be unique. Folders and assets that share the same name cause a namespace conflict, even if they are in different folder hierarchies.
Syntax
IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser
The user must have read access to the folder to return data on it.
Input (getFoldersParam)
Name | Type | Required | Description |
---|---|---|---|
companyHandle | xsd:string |
Yes | The handle to the company. |
accessUserHandle | xsd:string |
No | Used by administrators to impersonate a specific user. |
accessGroupHandle | xsd:string |
No | Filter by a specific group. |
folderPath | xsd:string |
No | The root folder to retrieve folders and all subfolders to the leaf level. If excluded, the company root is used. |
assetTypeArray | types:StringArray |
No | Returns folders that only contain specified asset types. |
responseFieldArray | types:StringArray |
No | Contains a list of fields that you want to include in the response. |
excludeFieldArray | types:StringArray |
No | Contains a list of fields you want to exclude from the response. |
Output (getFoldersReturn)
Name | Type | Required | Description |
---|---|---|---|
folderArray | types:FolderArray |
No | An array of folders that match the filter criteria. The response is limited to 100,000 folders maximum. |
permissionsSetArray | types:PermissionSetArray |
This code sample returns an array that contains all the folders for a company along with specific information about each folder.
Request
<ns1:getFoldersParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
<ns1:companyHandle>47</ns1:companyHandle>
</ns1:getFoldersParam>
Response
<getFoldersReturn xmlns="http://www.scene7.com/IpsApi/xsd">
<folderArray>
<items>
<folderHandle>MyCompany/</folderHandle>
<path>MyCompany/</path>
<hasSubfolders>false</hasSubfolders>
</items>
<items>
<folderHandle>MyCompany/eCatalogs/</folderHandle>
<path>MyCompany/eCatalogs/</path>
<hasSubfolders>false</hasSubfolders>
</items>
<items>
<folderHandle>MyCompany/PDF/</folderHandle>
<path>MyCompany/PDF/</path>
<hasSubfolders>false</hasSubfolders>
</items>
</folderArray>
</getFoldersReturn>