---
title: "Search knowledge documents"
method: POST
path: "/knowledge/search"
tags: ["Knowledge"]
---

# Search knowledge documents

`POST /knowledge/search`

Search through knowledge base documents using vector search and reranking.
Returns matching documents from help-center articles, FAQs/snippets, websites, news, YouTube videos,
and code knowledge. `limit` caps the number of returned documents; retrieval returns at most 10
documents regardless of a higher limit.

## Headers

- `project` string, required

## Request body

- KnowledgeSearchDto
  - `query` string, required
  - `documentTypeFilter` string
  - `internally` boolean
  - `lang` string
  - `limit` number, double — Max documents to return. Values above 10 have no effect; retrieval is capped at 10.
  - `scope` object
    - `tags` string[]
    - `mode` 'all' | 'include' | 'exclude', required

## Response `200`

Ok

- KnowledgeSearchResponse
  - `results` KnowledgeSearchResult[], required
    - `sourceId` string, required
    - `sourceType` string, required
    - `title` string
    - `content` string, required
    - `url` string
  - `count` number, double, required

---

[API](https://skmtc.net/gleap/apis/gleap-server.md) · [All operations](https://skmtc.net/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gleap/gleap-server/versions/2bfe054193b5/schema)