Search notes

Find bullets and documents by text, like the global search, with each result's parent path.

GET https://cotlet.dev/api/v1/remnote/notes/search

read

Searches the open knowledge base the way the Ctrl+P global search does and returns matching bullets with the document they live in and their ancestors. Pass tag to keep only bullets tagged with it, and parent_id to search inside one section only, like hierarchical search. Pass document_id from a result to get_document.

Parameters

Parameters: search_notes
NameTypeDescription
query string required string Text to search for.
tag string string Only bullets tagged with this tag.
parent_id string string Only inside this document or bullet.
limit integer integer 1 to 50. Default: 20.
cursor string string Next page cursor from the previous call.

Request

cURL
curl "https://cotlet.dev/api/v1/remnote/notes/search?query=query" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("remnote", "search_notes", {"query":"query"})
Node.js
const result = await cotlet.call('remnote', 'search_notes', {"query":"query"});
CLI
cotlet call remnote search_notes --data '{"query":"query"}'

Example response

JSON

{
  "results": [
    {
      "document_id": "rem_8f21a0",
      "text": "Krebs cycle",
      "is_document": true,
      "path": [
        "Biology",
        "Cell metabolism"
      ]
    },
    {
      "document_id": "rem_2c77e1",
      "text": "Citrate is the first product of the cycle",
      "is_document": false,
      "path": [
        "Biology",
        "Cell metabolism",
        "Krebs cycle"
      ]
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.