List notes

Returns the authenticated user’s notes. Authenticate with a personal API token that includes the notes:read scope.

GET/v1/public-api/notes

Authorization

AuthorizationBearer token · headerrequired

Query parameters

limitinteger

Maximum number of notes to return per page.

min 1 · max 100 · default: 20

cursorstring | any

Opaque pagination cursor returned by a previous list response.

created_afterstring<date-time> | any

Only return notes created after this ISO 8601 timestamp.

created_beforestring<date-time> | any

Only return notes created before this ISO 8601 timestamp.

updated_afterstring<date-time> | any

Only return notes updated after this ISO 8601 timestamp.

qstring | any

Search note titles, summaries, and transcripts.

tag_idstring<uuid>[] | any

Only return notes assigned to any supplied tag ID. Repeat this parameter to filter by multiple tags.

Responses

200Successful Response

itemsPublicNoteListItemResponse[]required

Notes for the current page.

Show properties

Array of PublicNoteListItemResponse

note_idstringrequired

Unique identifier for the note.

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

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.

next_cursorstring | any

Pagination cursor for the next page, if more results exist.

Show properties

Any of:

string

string

any

any

400The request included an invalid filter or cursor.

401Missing or invalid personal API token.

403The personal API token is missing the required scope.

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" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

import requests

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

Response

{
  "items": [
    {
      "note_id": "string",
      "title": "string",
      "summary": "string",
      "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"
    }
  ],
  "next_cursor": "string"
}