ghl_media_list_files
Retrieves paginated files and folders from media storage for a location, supporting query, parent folder, sorting, and offset/limit paging.
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)
Requires a Sub-Account (location) token.
OAuth scopes: medias.readonly
Pagination params: offset, limit — pass them to page through full result sets.
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": {
"sortBy": "<sortBy>",
"sortOrder": "<sortOrder>",
"type": "<type>",
"altType": "<altType>",
"altId": "<altId>"
},
"name": "ghl_media_list_files"
}
}Input 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 (e.g. updatedAt, name) | |
| 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 |