aps_get_folder_contents
Retrieve a summarized listing of folder contents with item counts, file type breakdowns, and size data in a compact JSON format that reduces API response size by approximately 95%.
Instructions
Get a summarised listing of a folder's contents. Returns a compact JSON with: summary (item counts, file type breakdown, total size), folders (name, id, item count), and files (name, id, type, size, version, dates). This is ~95 % smaller than the raw API response.
Supports optional filtering by file extension and hiding hidden items. For the full raw response, use aps_dm_request instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID – starts with 'b.'. | |
| folder_id | Yes | Folder URN – starts with 'urn:'. | |
| filter_extensions | No | Optional list of file extensions to include (e.g. [".rvt", ".nwd", ".ifc"]). Omit to return all file types. | |
| exclude_hidden | No | When true, exclude hidden items. Defaults to false. | |
| page_limit | No | Max items per page (1‑200). Defaults to 200. |