> ## 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.

# Plaud

> Read your Plaud voice-recorder library — recordings, transcripts, AI summaries, note tabs, devices, and search.

The Plaud group powers the **Plaud (Magic Meal Kits)** Make.com app. It is a read-only
facade over Plaud's web API: your server holds your Plaud credentials in Secret Manager,
so callers only ever send the MMK `X-API-KEY` header (see [Authentication](/authentication)).

<Note>
  **Every Plaud endpoint requires a Pro license.** A Basic key is rejected with `400`
  and `you are not a magic meal kits PRO user`.
</Note>

## Endpoints

| Endpoint                              | Tier    | What it does                                                    |
| ------------------------------------- | ------- | --------------------------------------------------------------- |
| `GET /plaud/user/me`                  | **Pro** | Profile, membership tier, remaining transcription seconds       |
| `GET /plaud/files`                    | **Pro** | List recordings (paginated, sortable)                           |
| `GET /plaud/files/{id}`               | **Pro** | Recording metadata only                                         |
| `GET /plaud/files/{id}/fetch`         | **Pro** | Bundle: file + transcript + summary + share + audio in one call |
| `GET /plaud/files/{id}/transcript`    | **Pro** | Transcript (optionally rendered to text/markdown/srt/vtt)       |
| `GET /plaud/files/{id}/summary`       | **Pro** | AI Markdown summary (images as pre-signed URLs)                 |
| `GET /plaud/files/{id}/tabs`          | **Pro** | List named note tabs (Summary, Key Points, …)                   |
| `GET /plaud/files/{id}/tabs/content`  | **Pro** | One tab's content, by `tab_id` or `template`                    |
| `GET /plaud/files/{id}/audio-url`     | **Pro** | Pre-signed S3 URL for the original audio                        |
| `GET /plaud/devices`                  | **Pro** | Bound Plaud hardware                                            |
| `GET /plaud/search`                   | **Pro** | Full-text search across transcripts                             |
| `GET /plaud/search/history`           | **Pro** | Recent search queries                                           |
| `GET /plaud/files/webhook-candidates` | **Pro** | Poll ready-to-ship recordings (new-recording trigger)           |

## Triggers

The **Watch New Note** instant trigger in the Make app is delivered by your server's
webhook orchestrator — it is not an endpoint you call. The **Watch New Recordings**
polling trigger reads `GET /plaud/files/webhook-candidates`, which returns only
recordings that are ready (not trashed, transcribed, and summarized).

## Notes

* **Readiness.** Use the `is_trans` / `is_summary` flags (on file objects) or the
  `409` not-ready response to skip recordings whose transcript/summary is still
  generating.
* **Pre-signed URLs expire.** Audio URLs and summary image URLs are short-lived S3 links
  (\~15 minutes) — fetch and use them promptly.
* **One bundle call.** Prefer `/files/{id}/fetch?include=transcript,summary` over three
  separate round trips when you need multiple attachments for the same recording.
* **Reconnect on `401`.** A `401` means your stored Plaud credentials were rejected
  (revoked/expired) — reconnect your Plaud account on the Magic Meal Kits app.

Use the interactive playground on each endpoint page to try a request with your own
deployment host and API key.