Skip to main content
GET
List notes
In the Heliyos MCP server: heliyos_notes_list.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Query Parameters

limit
integer
default:20

Notes per page, 1 to 100. Defaults to 20.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page. Only valid with the default order (newest first) and no page. next_cursor from the previous page; only valid with the default sort.

Maximum string length: 200
page
integer

A page number, starting at 1, for page-number paging. Pages are limit notes long.

Required range: x >= 1
filters
string

A JSON object, URL-encoded. Keys:

  • search (string): matches text in the title or body, case-insensitive.
  • relatedObjectId (id): only notes linked to this record, task or interaction.
  • filters (array): conditions { "field", "operator", "value" }. Fields: title, content, metadata.created.at, metadata.created.by. Operators: equals, not_equals, contains, after, before, gt, gte, lt, lte, in, empty, not_empty.
  • sort (array): { "field", "direction" } with direction asc or desc, for example [{"field": "metadata.updated.at", "direction": "desc"}]. JSON-encoded filter object (search, filters, sort, page, pageSize). Optional. pageSize above 200 is clamped to 200.
Maximum string length: 20000

Response

A page of notes.

meta
object
required
data
object[]
required