---
title: "List Library Folder Structure"
method: GET
path: "/library/folders"
tags: ["Library"]
---

# List Library Folder Structure

`GET /library/folders`

Retrieves the folder structure for the library. If folderUUID is provided, returns only the direct subfolders of that folder. If folderUUID is not provided, returns the root folder structure. This endpoint supports lazy loading of folder hierarchies for workflow builders.

## Query parameters

- `userUUID` string, required
- `folderUUID` string
- `myLibrary` boolean
- `includeHidden` boolean

## Response `200`

Folder structure successfully retrieved

- LibraryFolderStructureResponse
  - `data` LibraryFolder
    - `uuid` string — Unique identifier of the folder
    - `name` string — Name of the folder
    - `path` string — Full path to the folder from root
    - `parentUUID` string — UUID of the parent folder, empty if root
    - `hidden` boolean — Whether the folder is hidden
    - `userUUID` string — UUID of the user who owns this folder (for personal library folders)
    - `organizationUUID` string — UUID of the organization this folder belongs to
    - `subFolders` LibrarySubFolder[] — List of immediate subfolders
      - `uuid` string — Unique identifier of the subfolder
      - `name` string — Name of the subfolder
      - `parentUUID` string — UUID of the parent folder
      - `hidden` boolean — Whether the subfolder is hidden
      - `totalElements` integer — Total number of elements (snippets) in this folder
      - `totalFolders` integer — Total number of nested subfolders
    - `subFoldersTotal` integer — Total number of subfolders

## Other responses

- `401` — Authentication required. Please provide a valid API key.
- `500` — Unexpected server error. Please try again later.
- `default` — Unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)