> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attention List Library Folders: Inputs, Cost & CLI Example

> List Library Folder Structure. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=attention_list_library_folders:{"userUUID":"{{userUUID}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                    | Type      | Required | Default | Description                                                                                                                                                         |
| ----------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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.                                                                                                 |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "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.",
    "properties": {
      "userUUID": {
        "type": "string",
        "description": "UUID of the user. Required to fetch folder structure."
      },
      "folderUUID": {
        "type": "string",
        "description": "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": {
        "type": "boolean",
        "description": "If true, returns only the user's personal library folders. If false, returns organization-level library folders.",
        "default": false
      },
      "includeHidden": {
        "type": "boolean",
        "description": "If true, includes hidden folders in the response. Default is false.",
        "default": false
      }
    },
    "required": [
      "userUUID"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "uuid": {
                "type": "string",
                "description": "Unique identifier of the folder"
              },
              "name": {
                "type": "string",
                "description": "Name of the folder"
              },
              "path": {
                "type": "string",
                "description": "Full path to the folder from root"
              },
              "parentUUID": {
                "type": "string",
                "description": "UUID of the parent folder, empty if root"
              },
              "hidden": {
                "type": "boolean",
                "description": "Whether the folder is hidden"
              },
              "userUUID": {
                "type": "string",
                "description": "UUID of the user who owns this folder (for personal library folders)"
              },
              "organizationUUID": {
                "type": "string",
                "description": "UUID of the organization this folder belongs to"
              },
              "subFolders": {
                "type": "array",
                "description": "List of immediate subfolders",
                "items": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "description": "Unique identifier of the subfolder"
                    },
                    "name": {
                      "type": "string",
                      "description": "Name of the subfolder"
                    },
                    "parentUUID": {
                      "type": "string",
                      "description": "UUID of the parent folder"
                    },
                    "hidden": {
                      "type": "boolean",
                      "description": "Whether the subfolder is hidden"
                    },
                    "totalElements": {
                      "type": "integer",
                      "description": "Total number of elements (snippets) in this folder",
                      "format": "int64"
                    },
                    "totalFolders": {
                      "type": "integer",
                      "description": "Total number of nested subfolders",
                      "format": "int64"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "subFoldersTotal": {
                "type": "integer",
                "description": "Total number of subfolders",
                "format": "int64"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute attention_list_library_folders --payload '{
  "userUUID": "string"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

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