ghl_media_list_files
Read-onlyIdempotent
Retrieve a paginated list of files and folders from media storage. Filter by type, location, sort order, and more to manage media assets.
Instructions
Regression check (old connector 422'd here because it had no way to pass the required type param): VERIFIED FIXED — type, altType, altId, sortBy, sortOrder are all present and required in this tool's input schema, matching the spec.
Get List of Files/ Folders
Fetches list of files and folders from the media storage
Endpoint: GET /medias/files (Version header: v3; source: v3/medias-v3.json)
OAuth scopes: medias.readonly
Pagination params: offset, limit — pass them to page through full result sets.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Type | |
| altId | Yes | location Id | |
| limit | No | Number of files to show in the listing | |
| query | No | Query text | |
| offset | No | Number of files to skip in listing | |
| sortBy | Yes | Field to sorting the file listing by | |
| altType | Yes | AltType | |
| fetchAll | No | Fetch all files or folders | |
| parentId | No | parent id or folder id | |
| sortOrder | Yes | Direction in which file needs to be sorted |