v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Folder API

List Folders

List a team's folders of a given item_type as a flat list (use parent_folder_id to reconstruct the tree).

get/v2/folders

Query parameters

teamIdstring required

The ID of the team.

The ID of the team.

itemType'FOLDER_ITEM_TYPE_UNSPECIFIED' | 'FOLDER_ITEM_TYPE_FOLDER' | 'FOLDER_ITEM_TYPE_WORKFLOW' | 'FOLDER_ITEM_TYPE_GUIDANCE' required

Types of items that can appear in folder contents.

The non-folder item type of folders to list. Required — folders are scoped per type, and FOLDER_ITEM_TYPE_UNSPECIFIED and FOLDER_ITEM_TYPE_FOLDER are rejected.

parentFolderIdstring

Optional. When set, return only the direct children of this folder. When unset, return all folders of the given type for the team (a flat list; use parent_folder_id to reconstruct the tree).

Optional. When set, return only the direct children of this folder. When unset, return all folders of the given type for the team (a flat list; use parent_folder_id to reconstruct the tree).

pageSizeinteger

Maximum number of results to return. Default is 1000, maximum is 2000. When neither page_size nor page_token is set, all results are returned.

Maximum number of results to return. Default is 1000, maximum is 2000. When neither page_size nor page_token is set, all results are returned.

pageTokenstring

Token for pagination. Leave empty for the first request.

Token for pagination. Leave empty for the first request.

Response

Success

nextPageTokenstring nullable

Token for retrieving the next page of results. Empty if no more results.