---
title: "Search"
method: POST
path: "/v1/search"
tags: ["search"]
---

# Search

`POST /v1/search`

## Request

- Base URL: `https://api.heirmos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heirmos.com/v1/search`
- Auth: HTTP bearer

## Request body

- SearchRequest: POST /v1/search request — SPEC §5.3 line 388-398.
  - `query` string, required
  - `limit` integer
  - `filters` SearchFilters: Optional filter block — SPEC §5.3 line 392-396 + §6.4 (P9-10 ``source``).
    - `path_prefix` string, nullable
    - `tags` string[], nullable
    - `min_importance` number, nullable
    - `source` string, nullable

## Response `200`

Successful Response

- SearchResponse: POST /v1/search response — SPEC §5.3 line 401-413.
  - `results` SearchHit[], required
    - `path` string, required
    - `title` string, nullable
    - `summary` string, nullable
    - `score` number, required
    - `snippet` string, nullable
    - `matched_via` string[], required
    - `status` string, nullable
    - `summary_for_ai` string, nullable
    - `retrieval_keywords` string[], nullable
    - `related_memory_ids` string[], nullable
    - `folder_context` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/heirmos/apis/heirmos-api.md) · [All operations](https://skmtc.dev/heirmos/apis/heirmos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heirmos/apis/heirmos-api/revisions/ed490b1866e7?raw)