v2
library
folders
private
List Library Folders
List folders for the authenticated user.
Args: user_id: ID of the authenticated user. parent_id: Optional parent folder ID to filter by. include_relations: Whether to include agent and subfolder relations for counts.
Returns: A FolderListResponse containing folders.
get/api/library/folders
Query parameters
parent_idstring nullable
Filter by parent folder ID. If not provided, returns root-level folders.
Filter by parent folder ID. If not provided, returns root-level folders.
include_relationsboolean
Include agent and subfolder relations (for counts)
Include agent and subfolder relations (for counts)
Response
List of folders
Example response
{
"pagination": {
"total_items": 42,
"total_pages": 2,
"current_page": 1,
"page_size": 25
}
}