--- schema_version: "1" id: 86920205946e55d1f626dd2e827cc40ca1251422723e992c46190ce3669e28ce title: Folders List Resource collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_folders.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_folders.htm source_site: developer.salesforce.com content_type: documentation content_hash: 43ae3c15f5c624c695e3433ca4c8d75d03a0339a37c973e9d9092d8945719e6d description: Returns a collection of apps or folders and creates an Analytics app, which is a folder that contains Analytics dataset, lenses, and dashboard. --- # Folders List Resource Returns a collection of apps or folders and creates an Analytics app, which is a folder that contains Analytics dataset, lenses, and dashboard. ## Resource URL /wave/folders ## Formats JSON ## Available Version 36.0 ## Available in Postman To view and test a working example of this resource, see [getWaveFolderCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-1ef07cc4-fcb6-47f4-9bee-0262bfe41533?action=share&source=copy-link&creator=26106753 "HTML (New Window)") in Postman. For information about how to authenticate your org with Postman, see the [CRM Analytics Rest API Quick Start](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/crma_rest_api_quick_start.htm "Connect to a Salesforce Trailhead org and authenticate. Then make a request to the CRM Analytics REST API in Postman, and look at the response."). ## Available Components - Aura — [ createFolder()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_template.htm) - Aura — [ listFolders()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_template.htm) - LWC — [lightning/analyticsWaveApi getWaveFolders()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-wave-folders.html) - LWC — [lightning/analyticsWaveApi postWaveFolders()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-post-wave-folders.html) ## HTTP Methods GET POST ## Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
`isPinned`	Boolean	Indicates whether to filter the collection of folders to return only pinned folders (`true`) or not (`false`).	Optional	36.0
`mobileOnlyFeaturedAssets`	Boolean	Indicates whether to filter the collection of folders to show only dashboards that are enabled for the Analytics mobile app (`true`) or not (`false`).	Optional	43.0
`page`	String	A generated token that indicates the view of folders to be returned.	Optional	36.0
`pageSize`	Integer	The number of items to be returned in a single page. Minimum is 1, maximum is 200, and default is 25.	Optional	36.0
`q`	String	Search terms. Individual terms are separated by spaces. A wildcard is automatically appended to the last token in the query string. If the user’s search query contains quotation marks or wildcards, those symbols are automatically removed from the query string in the URI along with any other special characters.	Optional	36.0
`scope`	ConnectWaveScopeTypeEnum	The type of scope to be applied to the returned collection. Valid values are: `Browse` `CreatedByMe` `InsightsApplicationsIsCansEdit` `Mru` (Most Recently Used) `SharedWithMe`	Optional	38.0
`sort`	ConnectWaveSortOrderTypeEnum	The type of sort order to be applied to the returned collection. Valid values are: `App` `CreatedBy` `CreatedById` `CreatedDate` `FolderName` `LastModified` `LastModifiedBy` `LastModifiedById` `LastModifiedDate` `Location` `Mru` (Most Recently Used, last viewed date) `Name` `Outcome` `Owner` `RefreshDate` (for assets like datasets) `RunDate` (for assets like reports) `Status` `Title` `Type`	Optional	38.0
`templateFilters`	ConnectWaveTemplateSearchFiltersEnum	The filter templates to apply to the returned collection. Valid values are: `AppsConstructedByTemplate` `AppsWithInstallHistory`	Optional	57.0
`templateSourceId`	String	Filters the results to include only a collection of folders created from a specific template source	Optional	36.0

## Response body for GET [Wave Folder Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_wave_folder_collection.htm "A collection of Analytics folders.") ## Request body for POST This is a [Wave Folder Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_wave_folder_input.htm "An Analytics folder. This implements BaseWaveFolderInput.") or a [Wave Folder Template Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_wave_folder_template_input.htm "A templated Analytics folder. This implements BaseWaveFolderInput."), both of which implement the [Base Wave Folder Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_base_wave_folder_input.htm "The base Analytics folder asset."). ## Response body for POST [Wave Folder](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_wave_folder.htm "An Analytics folder.")