List IT Glue Document Folders
itglue_list_document_foldersRead-onlyIdempotent
List an organization's document folders, including nested folders, to browse the document tree or find a folder ID for creating documents. Filter by name or parent and return summary metadata.
Instructions
List the document folders (directories) in an organization, including nested folders. Returns summary metadata only (name, parent folder, document count). Use this to discover a document_folder_id for itglue_create_document, or to browse an organization's document tree. filter_name matches partially and case-insensitively; parent_id is the number in a folder's URL. A folder with parent_id null is top-level.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organization_id": "<organization_id>"
},
"name": "itglue_list_document_folders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort field (e.g. "name", "-updated_at") | |
| filter_id | No | Filter by folder ID | |
| page_size | No | Results per page (default 50, max 1000) | |
| filter_name | No | Filter by folder name (partial match) | |
| page_number | No | Page number (default 1) | |
| organization_id | Yes | Organization ID to list folders for | |
| response_format | No | Output format: human-readable markdown (default) or structured JSON | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| has_more | Yes | ||
| page_number | Yes | ||
| total_count | Yes |