> ## 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. # Start transcribe + summarize > Triggers Plaud's automatic transcript + summary pipeline for a recording without blocking, returning the immediate upstream response (the task runs async). All body fields are optional (zero values map to Plaud defaults: auto language, auto LLM, diarization on). When `check_quota` is `true`, insufficient transcription seconds return `402`. **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 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: post: tags: - AI summary: Start transcribe + summarize description: >- Triggers Plaud's automatic transcript + summary pipeline for a recording without blocking, returning the immediate upstream response (the task runs async). All body fields are optional (zero values map to Plaud defaults: auto language, auto LLM, diarization on). When `check_quota` is `true`, insufficient transcription seconds return `402`. **Pro license required.** A Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. operationId: startPlaudTransSumm parameters: - $ref: '#/components/parameters/FileId' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/TransSummRequest' example: language: auto diarization: true llm: auto summ_type: AUTO-SELECT responses: '200': description: Task accepted (async) content: application/json: schema: $ref: '#/components/schemas/TransSummResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/PlaudAuthError' '402': $ref: '#/components/responses/QuotaInsufficient' '502': $ref: '#/components/responses/UpstreamError' 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. TransSummResponse: type: object description: >- Immediate response from the async transsumm trigger. A successful call returns status=0 with msg="task processing"; extra fields are captured loosely for forward-compat. properties: status: type: integer msg: type: string request_id: type: string auto_save: type: boolean ppc_status: type: integer err_code: type: string err_msg: type: string data_extra: type: object additionalProperties: true ErrorResponse: type: object properties: error: type: string 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' 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. ````