---
title: "POST /api/notes/{note}/search"
method: POST
path: "/api/notes/{note}/search"
tags: ["search-controller"]
---

# POST /api/notes/{note}/search

`POST /api/notes/{note}/search`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/notes/{note}/search`
- Auth: none declared

## Path parameters

- `note` integer, required

## Request body

- SearchTerm
  - `searchKey` string, required
  - `allMyNotebooksAndSubscriptions` boolean
  - `allMyCircles` boolean

## Response `200`

OK

- RelationshipLiteralSearchHit[]
  - `hitKind` 'NOTE' | 'FOLDER' | 'NOTEBOOK', required
  - `noteSearchResult` NoteSearchResult
    - `noteTopology` NoteTopology, required
      - `id` integer, required
      - `title` string, required
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `notebookId` integer, required
    - `notebookName` string: Name of the notebook this result belongs to
    - `folderName` string: Containing folder name; omitted when the note is at notebook root
    - `distance` number, float
  - `folderId` integer: Present when hitKind is FOLDER
  - `folderName` string: Present when hitKind is FOLDER
  - `notebookId` integer: Notebook id for a folder or notebook hit
  - `notebookName` string: Notebook display name for a folder or notebook hit
  - `distance` number, float: Match score for folder or notebook literal hit (0 exact, 0.9 partial)

## Changes

- **2026-09-01** `409c54287106`: 1 info
  - added the optional property `items/noteSearchResult/folderName` to the response with the `200` status

[Operation history](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/changes/api/notes/:note/search/post.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api.md) - [All operations](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/revisions/f78415aa9270?raw)