> ## 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. # Bundle multiple recordings > Backend-for-frontend aggregator: lists recordings and composes each one's requested attachments (transcript/summary/share/audio) in a single call. Backs `mmk plaud file list --with transcripts,summaries`. **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 get /plaud/sync 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/sync: get: tags: - Files summary: Bundle multiple recordings description: >- Backend-for-frontend aggregator: lists recordings and composes each one's requested attachments (transcript/summary/share/audio) in a single call. Backs `mmk plaud file list --with transcripts,summaries`. **Pro license required.** A Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. operationId: syncPlaudFiles parameters: - name: limit in: query schema: type: integer default: 10 minimum: 1 maximum: 20 description: Max files (clamped to 1–20). - name: skip in: query schema: type: integer default: 0 description: Offset for pagination. - name: since in: query schema: type: integer format: int64 description: Only include files with `start_time` >= this epoch-ms value. - name: include in: query schema: type: string default: transcript,summary description: >- Comma-separated attachments to compose: `transcript`, `summary`, `share`, `audio_url`. - name: transcript_format in: query schema: type: string enum: - text - markdown - srt - vtt - json - plain description: Rendering applied to each bundled transcript's `text`. - name: strict in: query schema: type: boolean default: false description: Fail-fast on any sub-fetch error. - name: concurrency in: query schema: type: integer default: 4 minimum: 1 maximum: 8 description: Max in-flight files (clamped to 1–8). responses: '200': description: Aggregated bundles content: application/json: schema: $ref: '#/components/schemas/SyncResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/PlaudAuthError' '502': $ref: '#/components/responses/UpstreamError' components: schemas: SyncResponse: type: object properties: total: type: integer files: type: array items: $ref: '#/components/schemas/FileBundle' fetched_at: type: string format: date-time stats: type: object properties: bundle_errors: type: integer description: Files that had at least one sub-fetch error. elapsed_ms: type: integer 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). 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' 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. ````