Get a note

Returns the full details for a single note that belongs to the authenticated user, including a one-hour download URL for the original uploaded recording. Requires notes:read. Refresh an expired URL by fetching this note again or calling GET /v1/public-api/notes/{note_id}/audio-url. Recording access does not depend on transcription status.

GET/v1/public-api/notes/{note_id}

Authorization

AuthorizationBearer token · headerrequired

Personal API token created in Monologue Settings. Every public API request requires the `notes:read` scope.

Path parameters

note_idstring<uuid>required

Responses

200Successful Response

note_idstringrequired

Unique identifier for the note.

recording_urlstringrequired

One-hour signed download URL for the original uploaded audio.

recording_url_expires_atstring<date-time>required

UTC expiration time of the recording URL. Fetch a fresh URL after expiry.

recording_content_typestring | any

Recorded MIME type of the uploaded audio, when available.

Show properties

Any of:

string

string

any

any

recording_bytesinteger | any

Recorded size of the uploaded audio in bytes, when available.

Show properties

Any of:

integer

integer

any

any

titlestring | any

Generated or user-facing note title.

Show properties

Any of:

string

string

any

any

summarystring | any

Short summary of the note contents.

Show properties

Any of:

string

string

any

any

transcriptstring | any

Full transcript text for the note.

Show properties

Any of:

string

string

any

any

transcript_segmentsobject[] | any

Structured transcript segments, when available.

Show properties

Any of:

object[]

Array of object

object

any

any

tagsNoteTagResponse[]

Tags assigned to the note, including auto-tag metadata.

Show properties

Array of NoteTagResponse

tag_idstringrequired

namestringrequired

positionintegerrequired

created_atstring<date-time>required

updated_atstring<date-time>required

sourcestringrequired

Allowed:userauto

confidencenumber | any

Show properties

Any of:

number

number

any

any

recorded_atstring<date-time> | any

Timestamp when recording began, when supplied by the client.

Show properties

Any of:

string<date-time>

string<date-time>

any

any

created_atstring<date-time>required

Timestamp when the backend created the note.

updated_atstring<date-time>required

Timestamp when the note was last updated.

share_statusstring | any

Public share state: `enabled` for a live public link, `revoked` for a turned-off link, or null if the note has never been shared. Reading a note never turns sharing on. Personal API keys cannot change sharing.

Show properties

Any of:

string

string

any

any

share_idstring | any

Public share ID when sharing is enabled; otherwise null. A `note_id` is not a public link.

Show properties

Any of:

string

string

any

any

share_urlstring | any

Public link anyone with the URL can open, when sharing is enabled; otherwise null.

Show properties

Any of:

string

string

any

any

401Missing or invalid personal API token.

403The personal API token is missing the required scope.

404The note was not found for the authenticated user.

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

Request

curl -X GET "https://api.monologue.to/v1/public-api/notes/%3Cuuid%3E" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.monologue.to/v1/public-api/notes/%3Cuuid%3E", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.monologue.to/v1/public-api/notes/%3Cuuid%3E",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "note_id": "string",
  "recording_url": "string",
  "recording_url_expires_at": "2024-01-01T00:00:00Z",
  "recording_content_type": "string",
  "recording_bytes": 0,
  "title": "string",
  "summary": "string",
  "transcript": "string",
  "transcript_segments": [
    {}
  ],
  "tags": [
    {
      "tag_id": "string",
      "name": "string",
      "position": 0,
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z",
      "source": "user",
      "confidence": 0
    }
  ],
  "recorded_at": "2024-01-01T00:00:00Z",
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z",
  "share_status": "enabled",
  "share_id": "string",
  "share_url": "string"
}