Attention: List Library Folders

List Library Folder Structure.

Tool ID: attention_list_library_folders

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_list_library_folders',
  {
    "userUUID": "user_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute attention_list_library_folders --input '{
  "userUUID": "user_123"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "data": {
      "uuid": "uuid_123",
      "name": "Example",
      "path": "example"
    }
  }
}

Use deepline tools get attention_list_library_folders --json for the latest machine-readable contract.

Input reference

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.

Name	Type	Required	Default	Details
`payload.userUUID`	`string`	Yes	—	UUID of the user. Required to fetch folder structure.
`payload.folderUUID`	`string`	No	—	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.
`payload.myLibrary`	`boolean`	No	`false`	If true, returns only the user’s personal library folders. If false, returns organization-level library folders.
`payload.includeHidden`	`boolean`	No	`false`	If true, includes hidden folders in the response. Default is false.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`object`	No	—	—
`result.data.data.uuid`	`string`	No	—	Unique identifier of the folder
`result.data.data.name`	`string`	No	—	Name of the folder
`result.data.data.path`	`string`	No	—	Full path to the folder from root
`result.data.data.parentUUID`	`string`	No	—	UUID of the parent folder, empty if root
`result.data.data.hidden`	`boolean`	No	—	Whether the folder is hidden
`result.data.data.userUUID`	`string`	No	—	UUID of the user who owns this folder (for personal library folders)
`result.data.data.organizationUUID`	`string`	No	—	UUID of the organization this folder belongs to
`result.data.data.subFolders`	`array`	No	—	List of immediate subfolders
`result.data.data.subFolders[].uuid`	`string`	No	—	Unique identifier of the subfolder
`result.data.data.subFolders[].name`	`string`	No	—	Name of the subfolder
`result.data.data.subFolders[].parentUUID`	`string`	No	—	UUID of the parent folder
`result.data.data.subFolders[].hidden`	`boolean`	No	—	Whether the subfolder is hidden
`result.data.data.subFolders[].totalElements`	`integer`	No	—	Total number of elements (snippets) in this folder Format: `int64`.
`result.data.data.subFolders[].totalFolders`	`integer`	No	—	Total number of nested subfolders Format: `int64`.
`result.data.data.subFoldersTotal`	`integer`	No	—	Total number of subfolders Format: `int64`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Get started

Build and automate

Common workflows

Data and integrations

Reference

Attention: List Library Folders

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation