Public API quickstart

Create a personal token and retrieve your first page of Voice Notes.

1. Create a personal API token

On Mac, open Settings → Notes → API Keys. Create a key with the notes:read scope and copy the token when it appears. The full secret is shown only once.

export MONOLOGUE_API_TOKEN="mono_pat_..."

Treat this token like a password. Do not put it in browser code, mobile apps, source control, screenshots, or support messages.

2. List your notes

curl --request GET \
  --url "https://api.monologue.to/v1/public-api/notes?limit=10" \
  --header "Authorization: Bearer $MONOLOGUE_API_TOKEN"

The response returns note summaries and an opaque cursor for the next page:

{
  "items": [
    {
      "note_id": "0198b68f-c6e1-7891-a341-803eb8fe421f",
      "title": "Launch review",
      "summary": "The team reviewed the launch plan.",
      "tags": [],
      "created_at": "2026-07-20T10:30:00Z",
      "updated_at": "2026-07-20T10:35:00Z"
    }
  ],
  "next_cursor": null
}

3. Retrieve the full note

curl --request GET \
  --url "https://api.monologue.to/v1/public-api/notes/0198b68f-c6e1-7891-a341-803eb8fe421f" \
  --header "Authorization: Bearer $MONOLOGUE_API_TOKEN"

The detail response also includes the transcript, transcript segments, and a one-hour recording_url for the original uploaded audio. Download that URL without sending your API token. To refresh an expired link, request GET /v1/public-api/notes/{note_id}/audio-url with your token; it returns audio_url and expires_in in seconds.

Continue with filtering, pagination, and recording downloads or webhooks.