Skip to main content
GET
/
library
/
folders
List Library Folder Structure
curl --request GET \
  --url https://api.attention.tech/v2/library/folders \
  --header 'Authorization: <api-key>'
{
  "data": {
    "uuid": "folder-uuid-root",
    "name": "Sales Library",
    "organizationUUID": "org-uuid-123",
    "parentUUID": "",
    "path": "/Sales Library",
    "hidden": false,
    "subFolders": [
      {
        "uuid": "folder-uuid-sub-1",
        "name": "Best Practices",
        "parentUUID": "folder-uuid-root",
        "hidden": false,
        "totalElements": 15,
        "totalFolders": 2
      }
    ],
    "subFoldersTotal": 3
  }
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
userUUID
string
required

UUID of the user. Required to fetch folder structure.

​
folderUUID
string

UUID of the folder to fetch subfolders from. If not provided, returns root folder structure. When provided, returns only direct subfolders of the specified folder.

​
myLibrary
boolean
default:false

If true, returns only the user's personal library folders. If false, returns organization-level library folders.

​
includeHidden
boolean
default:false

If true, includes hidden folders in the response. Default is false.

Response

Folder structure successfully retrieved

​
data
object
Example:
{
  "uuid": "folder-uuid-root",
  "name": "Sales Library",
  "organizationUUID": "org-uuid-123",
  "parentUUID": "",
  "path": "/Sales Library",
  "hidden": false,
  "userUUID": "",
  "subFolders": [
    {
      "uuid": "folder-uuid-sub-1",
      "name": "Best Practices",
      "parentUUID": "folder-uuid-root",
      "hidden": false,
      "totalElements": 15,
      "totalFolders": 2
    }
  ],
  "subFoldersTotal": 3
}