---
title: "Search Knowledge Route"
method: POST
path: "/api/v1/knowledge/search"
tags: ["knowledge"]
---

# Search Knowledge Route

`POST /api/v1/knowledge/search`

Knowledge retrieval (keyword / vector / hybrid).

## Request body

- KnowledgeSearchRequest — Request body for POST /search.
  - `query` string, required
  - `method` 'keyword' | 'vector' | 'hybrid'
  - `top_k` integer
  - `score_threshold` number, nullable
  - `include_content` boolean
  - `app_id` string
  - `project_id` string

## Response `200`

Successful Response

- SuccessEnvelopeKnowledgeSearchResponse
  - `request_id` string, required
  - `data` KnowledgeSearchResponse, required — Response for POST /search.
    - `hits` SearchHitDTO[], required
      - `topic_id` string, required
      - `category_id` string, required
      - `topic_name` string, required
      - `topic_path` string, required
      - `depth` integer, required
      - `summary` string, required
      - `content` string, nullable, required
      - `score` number, required
      - `retrieval_method` string, required
      - `source` string, nullable, required
      - `document` DocumentContextDTO, required — L1 document metadata attached to every search hit.
        - `doc_id` string, required
        - `title` string, required
        - `summary` string, required
    - `total` integer, required
    - `took_ms` number, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-24** `65f2f4743b36` — 1 info
  - endpoint added
- **2026-06-05** `7be97420eb25` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/evermind-ai/apis/everos/changes/api/v1/knowledge/search/post.md)

---

[API](https://skmtc.dev/evermind-ai/apis/everos.md) · [All operations](https://skmtc.dev/evermind-ai/apis/everos/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evermind-ai/everos/revisions/9a2e78d664d6/schema)