v1

latestOpenAPI 3.1.1Proprietary2026-07-2687313591.4 KB
Notes

Search Notes by Keyword

Search notes by keyword. The scope of the search is controlled by the request body:

  • Provide noteIds to limit the search to specific notes.
  • Provide companyId to limit the search to notes associated with a specific company.
  • Omit both to search across your entire account.

noteIds and companyId are mutually exclusive.

Returns up to limit notes ordered by relevance. Prompts with no strong matches may still return low-relevance results.

Each result contains a matched note and a single representative excerpt (a matching passage from that note). Even if a note contains multiple matching passages, it appears exactly once in the response with one excerpt.

post/v2/notes/search

Request body

OR

Example request

{
  "prompt": "Series B terms",
  "noteIds": [
    1,
    2
  ],
  "limit": 20
}

Response

Created

Example response

{
  "data": [
    {
      "note": {
        "id": 1,
        "kind": "note"
      },
      "preview": "We discussed the Series B terms with the founding team last Thursday."
    }
  ]
}