List Media Files
list_mediaRead-onlyIdempotent
List and search media files with filters for type, name, folder, date range, and favorites. Include transcripts, speakers, or keywords inline to avoid extra API calls.
Instructions
List and search media files in the workspace with filtering, pagination, and sorting. Use filterName for text search, mediaType to filter by audio/video/text, folderId for folder-specific results, and from/to for date ranges. Use the include param to embed additional data (transcripts, speakers, keywords) inline with each result, avoiding N+1 API calls. Returns mediaIds you can pass to get_transcript, get_media_insights, or ask_magic_prompt. For deep full-text search across transcripts, use search_media instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End date for date range filter (ISO 8601) | |
| from | No | Start date for date range filter (ISO 8601) | |
| page | No | Page number for pagination (0-based, default: 0) | |
| sortBy | No | Sort field and direction, e.g. "createdAt:desc" or "name:asc" | |
| include | No | Additional data to include with each media item. Without this, only metadata is returned. Use 'transcription' to include full transcripts inline, 'speakers' for speaker details, 'keywords' for extracted keywords, etc. Avoids N+1 API calls when you need data for multiple files. | |
| folderId | No | Filter media within a specific folder | |
| pageSize | No | Number of results per page (default: 20, max: 500) | |
| mediaType | No | Filter by media type: "audio", "video", or "text" | |
| filterName | No | Filter media by partial name match | |
| filterMedia | No | Filter: 0=Uploaded, 1=Assigned, 2=Both (default: 2) | |
| isFavorites | No | Filter to only show favorited media |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Response payload from the Speak AI API |