Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keywords
string[]

Alternative keyword searches in titles and shared summaries. All tokens of at least one entry must match.

Required array length: 1 - 20 elements
Required string length: 1 - 200
participant
string

Participant name, email, company or domain from calendar metadata. Filters attendance, not mentions in notes.

Required string length: 1 - 200
folder_id
string
Pattern: ^[Ff][Oo][Ll]_[a-zA-Z0-9]{14}$
space_id
string

Return notes in this space and its folders. Space IDs are case-insensitive. Use List spaces to discover accessible spaces. When folder_id is also provided, both filters apply.

Pattern: ^[Ss][Pp][Aa]_[a-zA-Z0-9]{14}$
Example:

"spa_8kTq2mWxLp4Rz7"

from_date

Inclusive meeting start time, falling back to note creation time. Accepts a date or UTC timestamp; a date means midnight UTC.

Example:

"2026-01-27"

to_date

Inclusive meeting end bound, using calendar start or note creation time. Accepts a date or UTC timestamp; a date means midnight UTC, not the end of that day.

Example:

"2026-01-27"

updated_after

Only notes whose content or shared summary changed after this date or UTC timestamp. A date means midnight UTC.

Example:

"2026-01-27"

page_size
integer
default:10

Maximum number of notes to return per page

Required range: 1 <= x <= 30
Example:

10

cursor
string

Continue a search. Only page_size may accompany a cursor.

Required string length: 1 - 2048

Response

Matching note metadata and search continuation status

notes
object[]
required
hasMore
boolean
required

Whether another page can be fetched using cursor.

cursor
string | null
required

The next-page cursor, or null when hasMore is false.

completion_status
enum<string>
required

more_available: continue with cursor. exhausted: no more matches. incomplete: the scan limit was reached; hasMore is false and cursor is null. Start a narrower search.

Available options:
more_available,
exhausted,
incomplete