Monologue Public API

Read your notes with a personal API token, and receive webhook events when notes finish processing. All API endpoints in this reference require the notes:read scope; the Webhooks section documents the events Monologue delivers to your endpoint and how to verify them.

To download an original recording, list your notes, then fetch GET /v1/public-api/notes/{note_id} and download its recording_url. List responses do not include recording links. The URL expires after one hour; fetch the note again or call GET /v1/public-api/notes/{note_id}/audio-url for a fresh audio_url and expires_in (seconds). Download the returned URL without forwarding your API token to storage.

curl -H "Authorization: Bearer $MONOLOGUE_API_TOKEN" \
  "https://api.monologue.to/v1/public-api/notes/$NOTE_ID/audio-url"
# Download the audio_url from the JSON response:
curl --fail --output recording.m4a "$AUDIO_URL"

Recordings retain their uploaded format; choose an output extension appropriate to the note’s recording_content_type when available. Signed URLs grant access to anyone holding them until expiry, even if the API token is revoked. A signed URL does not verify file availability; a removed recording can fail to download while the note’s text remains accessible.

Version 0.1.0

Base URLhttps://api.monologue.to

Notes

Read the authenticated user’s notes with a personal API token.