> ## Documentation Index > Fetch the complete documentation index at: https://docs.magicmealkits.com/llms.txt > Use this file to discover all available pages before exploring further. # Transcribe + summarize (wait) > Triggers transcribe + summarize, polls until the task completes, then returns the composed file bundle (transcript + summary + optional audio URL) — the same shape as `GET /files/{id}/fetch`. Pre-flight quota check is ON by default here (`{"check_quota": false}` to skip). Returns `402` on insufficient quota and `504` if the task does not finish within the timeout. **Pro license required.** A Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. ## OpenAPI ````yaml /api-reference/plaud/openapi.json post /plaud/files/{id}/transsumm/wait openapi: 3.1.0 info: title: Magic Meal Kits — Plaud API version: 1.0.0 description: >- Read your Plaud voice-recorder library — recordings, transcripts, AI summaries, note tabs, devices, and search — through your Magic Meal Kits server. Backs the **Plaud (Magic Meal Kits)** Make.com app. Your Plaud account credentials live server-side (Secret Manager) on your deployment; callers only send the MMK API key. Every endpoint requires a **Pro** license — a Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://{deployment}/api/v1 description: Your Magic Meal Kits deployment variables: deployment: default: magic-meal-kits-xxxxx.run.app description: Your Cloud Run host (without protocol) security: - ApiKeyAuth: [] tags: - name: User description: Account profile and membership. - name: Files description: List, inspect, and bundle recordings. - name: Content description: Transcripts, summaries, note tabs, and audio. - name: Search description: Full-text search across transcripts. - name: Devices description: Bound Plaud hardware. - name: Webhooks description: Polling source for new-recording triggers. - name: Folders description: 'Tags (used as folders): list, create, assign/clear, and one-call organize.' - name: AI description: >- Auto transcribe + summarize, task status, transcription quota, and summary models. - name: System description: Diagnostics, membership, config, and background-task status. paths: /plaud/files/{id}/transsumm/wait: post: tags: - AI summary: Transcribe + summarize (wait) description: >- Triggers transcribe + summarize, polls until the task completes, then returns the composed file bundle (transcript + summary + optional audio URL) — the same shape as `GET /files/{id}/fetch`. Pre-flight quota check is ON by default here (`{"check_quota": false}` to skip). Returns `402` on insufficient quota and `504` if the task does not finish within the timeout. **Pro license required.** A Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. operationId: waitPlaudTransSumm parameters: - $ref: '#/components/parameters/FileId' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/TransSummRequest' example: language: auto poll_interval_sec: 3 timeout_sec: 300 include: - transcript - summary responses: '200': description: Completed bundle content: application/json: schema: $ref: '#/components/schemas/FileBundle' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/PlaudAuthError' '402': $ref: '#/components/responses/QuotaInsufficient' '409': $ref: '#/components/responses/NotReady' '502': $ref: '#/components/responses/UpstreamError' '504': description: The transsumm task did not complete within the timeout. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: parameters: FileId: name: id in: path required: true schema: type: string description: Plaud recording (file) ID. schemas: TransSummRequest: type: object description: All fields optional; an empty body uses Plaud defaults. properties: language: type: string description: Transcript language; default `auto`. timezone: type: integer description: Signed UTC offset (hours). Default 0. diarization: type: boolean description: Speaker diarization. Default true. llm: type: string description: >- Summary model id (`model_name` from /summary/models). Default `auto`. summ_type: type: string description: Summary template. Default `AUTO-SELECT`. is_reload: type: boolean description: >- Force re-transcribe. Auto-detected when omitted (reloads if a transcript already exists). check_quota: type: boolean description: >- Pre-flight quota check. Default false on `/transsumm`, true on `/transsumm/wait`. Insufficient quota returns 402. poll_interval_sec: type: integer description: (wait only) Poll interval, clamped to 1–30s. timeout_sec: type: integer description: (wait only) Max wait, clamped to 10s–30m. include: type: array items: type: string enum: - transcript - summary - share - audio_url description: (wait only) Attachments to compose in the returned bundle. FileBundle: type: object description: >- File detail plus opted-in attachments. `file` is the inner file-detail object (`file.file_id`, …), not a `{status,data}` envelope. `transcript`/`summary`/`share`/`audio_url` appear only when requested via `include` and the fetch succeeded. properties: file: $ref: '#/components/schemas/FileDetailData' transcript: $ref: '#/components/schemas/Transcript' summary: $ref: '#/components/schemas/Summary' share: type: object description: Private/public share state — present only when `include=share`. properties: private: type: object additionalProperties: true public: type: object additionalProperties: true audio_url: type: string errors: type: array items: type: string description: Per-attachment failures (non-strict mode). not_ready: type: array items: type: string description: Requested attachments that are not generated yet. ErrorResponse: type: object properties: error: type: string FileDetailData: type: object description: >- Inner file-detail object — the `data` of FileDetailResponse and the `file` of a bundle. properties: file_id: type: string file_name: type: string duration: type: integer format: int64 is_trash: type: boolean start_time: type: integer format: int64 filetag_id_list: type: array items: type: string is_trans: type: boolean is_summary: type: boolean Transcript: type: object properties: file_id: type: string content: description: >- Decoded transcript payload (object or array of speaker-labeled segments). text: type: string description: Rendered transcript — present only when `format` was requested. format: type: string description: Echoes the requested format. Summary: type: object properties: file_id: type: string source: type: string enum: - inline - s3 markdown: type: string description: Summary as Markdown with image paths rewritten to pre-signed URLs. images: type: array items: type: object properties: path: type: string url: type: string description: Pre-signed S3 URL (~15-min TTL). QuotaError: type: object properties: error: type: string example: insufficient_transcription_quota message: type: string file_id: type: string remain_seconds: type: number required_seconds: type: number usage_reached: type: boolean is_starter: type: boolean responses: BadRequest: description: >- Invalid request (e.g. missing/blank required field), or the Pro-license gate: a Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' PlaudAuthError: description: >- Plaud credentials rejected (revoked/expired) — reconnect your Plaud account. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' QuotaInsufficient: description: Not enough transcription seconds remaining to transcribe this recording. content: application/json: schema: $ref: '#/components/schemas/QuotaError' NotReady: description: >- The requested attachment is not generated yet (e.g. transcription still running) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UpstreamError: description: >- Plaud upstream returned an error (surfaced as `502` with `upstream_status`/`upstream_msg`). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY description: >- Your deployment's API key (MMK_API_KEY). Your Plaud account credentials are stored server-side — you do not send them. ````