List Library Folder Structure
curl --request GET \
--url https://api.attention.tech/v2/library/folders \
--header 'Authorization: <api-key>'import requests
url = "https://api.attention.tech/v2/library/folders"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.attention.tech/v2/library/folders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/library/folders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/library/folders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.attention.tech/v2/library/folders")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/library/folders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}{
"code": 401,
"message": "unauthenticated for Invalid API key"
}{
"code": "500",
"detail": "An unexpected error occurred on the server. Please try again later or contact support if the problem persists.",
"id": "internal_server_error",
"title": "Internal Server Error"
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Library
List Library Folder Structure
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.
GET
/
library
/
folders
List Library Folder Structure
curl --request GET \
--url https://api.attention.tech/v2/library/folders \
--header 'Authorization: <api-key>'import requests
url = "https://api.attention.tech/v2/library/folders"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.attention.tech/v2/library/folders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/library/folders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/library/folders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.attention.tech/v2/library/folders")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/library/folders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}{
"code": 401,
"message": "unauthenticated for Invalid API key"
}{
"code": "500",
"detail": "An unexpected error occurred on the server. Please try again later or contact support if the problem persists.",
"id": "internal_server_error",
"title": "Internal Server Error"
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Authorizations
Query Parameters
UUID of the user. Required to fetch folder structure.
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.
If true, returns only the user's personal library folders. If false, returns organization-level library folders.
If true, includes hidden folders in the response. Default is false.
Response
Folder structure successfully retrieved
Show child attributes
Show child attributes
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 }
Was this page helpful?