Ask AI About Your Recordings
ask_magic_promptQuery your media files with natural language questions using AI. Supports single files, folders, or entire workspace with specialized assistant roles for tailored answers.
Instructions
Ask an AI-powered question about your media using Speak AI's Magic Prompt. Supports querying a single file, multiple files, entire folders, or your whole workspace. Pass mediaIds for specific files, folderIds for entire folders, or omit both to search across all media. Use assistantType to get specialized responses (e.g., 'researcher' for academic analysis, 'sales' for deal insights). To continue a conversation, pass the promptId from a previous response. Returns a promptId — save it to continue the conversation with follow-up questions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Filter media by tags | |
| prompt | Yes | The question or prompt to ask about the media | |
| endDate | No | End date for date range filter (ISO 8601, e.g., '2025-03-31') | |
| fieldId | No | Scope the prompt to a single custom field | |
| filters | No | Advanced filter object to scope which media the prompt runs over | |
| fieldIds | No | Scope the prompt to multiple custom fields (max 10) | |
| folderId | No | Single folder ID to scope the query to. Use folderIds for multiple folders. | |
| mediaIds | No | Array of media IDs to query. Omit along with folderIds to search across all media in your workspace. | |
| promptId | No | ID of an existing conversation to continue. Pass this to maintain chat context across multiple questions. | |
| speakers | No | Filter to specific speaker IDs from the transcript | |
| folderIds | No | Array of folder IDs to scope the query to. Omit along with mediaIds to search across all media. | |
| startDate | No | Start date for date range filter (ISO 8601, e.g., '2025-01-01') | |
| assistantType | No | Assistant persona: 'general' (default), 'researcher' (academic), 'marketer' (content), 'sales' (deals), 'recruiter' (hiring). Use 'custom' with assistantTemplateId. | |
| isIndividualPrompt | No | When true, processes each media file separately instead of combining context. Useful for comparing responses across files. | |
| assistantTemplateId | No | Required when assistantType is 'custom'. ID of a custom assistant template from list_prompts. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Response payload from the Speak AI API |