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

# Search Knowledge

`POST /v1/knowledge/search`

Searches through your Knowledge Base and returns items most relevant to the provided query. This endpoint is designed to support natural language search, allowing you to find Knowledge based on meaning and context—not just exact keyword matches.

## Request body

- SearchKnowledgeRequestDto
  - `query` string, required — The search query to find relevant Knowledge items. Supports natural language search.

## Response `201`

Successfully retrieved list of Knowledge by relevance to the query.

- SearchKnowledgeResponseDto
  - `requestId` string
  - `resource` string
  - `data` ScoredKnowledgeDto[] — Array of Knowledge items with relevant chunks, ordered by relevance
    - `id` string, required — The unique identifier of the Knowledge item
    - `name` string, required — The name of the Knowledge item
    - `summary` string, required — The summary of the Knowledge item
    - `tags` string[], required — Tags associated with the Knowledge item
    - `relevantChunks` RelevantChunkDto[], required — Array of relevant content chunks from the Knowledge item, ordered by relevance score
      - `content` string, required — The content of the relevant chunk from the Knowledge item
      - `score` number, required — The relevance score of this chunk (0-1, where 1 is most relevant)

## Other responses

- `400` — Bad request. May be missing required inputs or may have badly formatted inputs or options.
- `500` — Internal server error. Unable to search Knowledge.

---

[API](https://skmtc.net/jasper/apis/jasper-api.md) · [All operations](https://skmtc.net/jasper/apis/jasper-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jasper/jasper-api/versions/438914d9525e/schema)