---
title: "Changes to Search knowledge base"
method: POST
path: "/v2/knowledge/{knowledge_id}/search"
---

# Changes to Search knowledge base

`POST /v2/knowledge/{knowledge_id}/search`

> Every recorded change to this endpoint, newest first.
> 257 revisions in range; 71 not diffed.

## Timeline

Changed in 10 of 257 revisions.

- **2026-08-24** `addad33219df` — 9 breaking, 9 warning, 3 info
- **2026-08-21** `1586760a252f` — 8 breaking, 3 warning, 11 info
- **2026-08-21** `4fdc24e562eb` — 9 breaking, 9 warning, 3 info
- **2026-08-20** `be3fe58ce389` — 8 breaking, 3 warning, 11 info
- **2026-08-19** `ab4fda96e4a7` — 6 warning, 2 info
- **2026-08-17** `f54fa34db0f4` — 9 breaking, 9 warning, 3 info
- **2026-08-17** `ed68e8b009d7` — 8 breaking, 6 warning, 11 info
- **2026-08-17** `d46bd23ae34c` — 9 breaking, 9 warning, 3 info
- **2026-08-17** `f459ad9381eb` — 4 breaking, 1 info
- **2026-08-14** `deb8d376faee` — 5 info

## Changes

- **2026-08-24** `addad33219df` — 9 breaking, 9 warning, 3 info
  - request body became required
  - added `#/components/schemas/SearchOptions` to the `search_options` request property `allOf` list
  - added `#/components/schemas/SearchRerankConfig` to the `rerank_config` request property `allOf` list
  - the `agentic_rag_config` request property type/format changed from `object`/`` to ``/``
  - the `rerank_config` request property type/format changed from `object`/`` to ``/``
  - the `search_options` request property type/format changed from `object`/`` to ``/``
  - the `threshold` request property type/format changed from `number`/`` to `number`/`double`
  - the `top_k` request property type/format changed from `integer`/`` to `integer`/`int32`
  - the `matches/items/scores` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `agentic_rag_config/model`
  - removed the request property `rerank_config/model`
  - removed the request property `rerank_config/threshold`
  - removed the request property `rerank_config/top_k`
  - removed the request property `search_options/include_metadata`
  - removed the request property `search_options/include_scores`
  - removed the request property `search_options/include_vectors`
  - removed the optional property `matches/items/scores/rerank_score` from the response with the `200` status
  - removed the optional property `matches/items/scores/search_score` from the response with the `200` status
  - added the new optional request property `retrieval_config`
  - added `subschema #1, subschema #2` to the `agentic_rag_config` request property `anyOf` list
  - added `#/components/schemas/SearchKnowledgeScores` to the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-21** `1586760a252f` — 8 breaking, 3 warning, 11 info
  - added the new required request property `agentic_rag_config/model`
  - added the new required request property `rerank_config/model`
  - removed `subschema #1, subschema #2` from the `agentic_rag_config` request property `anyOf` list
  - the `agentic_rag_config` request property type/format changed from ``/`` to `object`/``
  - the `rerank_config` request property type/format changed from ``/`` to `object`/``
  - the `search_options` request property type/format changed from ``/`` to `object`/``
  - the `matches/items/scores` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `matches/items/vector/items/` response's property type/format changed from `number`/`double` to `number`/`` for status `200`
  - removed `#/components/schemas/SearchOptions` from the `search_options` request property `allOf` list
  - removed `#/components/schemas/SearchRerankConfig` from the `rerank_config` request property `allOf` list
  - removed the request property `retrieval_config`
  - added the new optional request property `rerank_config/threshold`
  - added the new optional request property `rerank_config/top_k`
  - added the new optional request property `search_options/include_metadata`
  - added the new optional request property `search_options/include_scores`
  - added the new optional request property `search_options/include_vectors`
  - request body became optional
  - the `threshold` request property type/format was generalized from `number`/`double` to `number`/``
  - the `top_k` request property type/format was generalized from `integer`/`int32` to `integer`/``
  - added the optional property `matches/items/scores/rerank_score` to the response with the `200` status
  - added the optional property `matches/items/scores/search_score` to the response with the `200` status
  - removed `#/components/schemas/SearchKnowledgeScores` from the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-21** `4fdc24e562eb` — 9 breaking, 9 warning, 3 info
  - request body became required
  - added `#/components/schemas/SearchOptions` to the `search_options` request property `allOf` list
  - added `#/components/schemas/SearchRerankConfig` to the `rerank_config` request property `allOf` list
  - the `agentic_rag_config` request property type/format changed from `object`/`` to ``/``
  - the `rerank_config` request property type/format changed from `object`/`` to ``/``
  - the `search_options` request property type/format changed from `object`/`` to ``/``
  - the `threshold` request property type/format changed from `number`/`` to `number`/`double`
  - the `top_k` request property type/format changed from `integer`/`` to `integer`/`int32`
  - the `matches/items/scores` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `agentic_rag_config/model`
  - removed the request property `rerank_config/model`
  - removed the request property `rerank_config/threshold`
  - removed the request property `rerank_config/top_k`
  - removed the request property `search_options/include_metadata`
  - removed the request property `search_options/include_scores`
  - removed the request property `search_options/include_vectors`
  - removed the optional property `matches/items/scores/rerank_score` from the response with the `200` status
  - removed the optional property `matches/items/scores/search_score` from the response with the `200` status
  - added the new optional request property `retrieval_config`
  - added `subschema #1, subschema #2` to the `agentic_rag_config` request property `anyOf` list
  - added `#/components/schemas/SearchKnowledgeScores` to the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-20** `be3fe58ce389` — 8 breaking, 3 warning, 11 info
  - added the new required request property `agentic_rag_config/model`
  - added the new required request property `rerank_config/model`
  - removed `subschema #1, subschema #2` from the `agentic_rag_config` request property `anyOf` list
  - the `agentic_rag_config` request property type/format changed from ``/`` to `object`/``
  - the `rerank_config` request property type/format changed from ``/`` to `object`/``
  - the `search_options` request property type/format changed from ``/`` to `object`/``
  - the `matches/items/scores` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `matches/items/vector/items/` response's property type/format changed from `number`/`double` to `number`/`` for status `200`
  - removed `#/components/schemas/SearchOptions` from the `search_options` request property `allOf` list
  - removed `#/components/schemas/SearchRerankConfig` from the `rerank_config` request property `allOf` list
  - removed the request property `retrieval_config`
  - added the new optional request property `rerank_config/threshold`
  - added the new optional request property `rerank_config/top_k`
  - added the new optional request property `search_options/include_metadata`
  - added the new optional request property `search_options/include_scores`
  - added the new optional request property `search_options/include_vectors`
  - request body became optional
  - the `threshold` request property type/format was generalized from `number`/`double` to `number`/``
  - the `top_k` request property type/format was generalized from `integer`/`int32` to `integer`/``
  - added the optional property `matches/items/scores/rerank_score` to the response with the `200` status
  - added the optional property `matches/items/scores/search_score` to the response with the `200` status
  - removed `#/components/schemas/SearchKnowledgeScores` from the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-19** `ab4fda96e4a7` — 6 warning, 2 info
  - the `rerank_config/allOf[#/components/schemas/SearchRerankConfig]/threshold` request property's max was set to `1.00`
  - the `rerank_config/allOf[#/components/schemas/SearchRerankConfig]/top_k` request property's max was set to `100.00`
  - the `threshold` request property's max was set to `1.00`
  - the `top_k` request property's max was set to `100.00`
  - the `rerank_config/allOf[#/components/schemas/SearchRerankConfig]/top_k` request property's min was set to `1.00`
  - the `top_k` request property's min was set to `1.00`
  - the `threshold` request property default value changed from `0` to `0`
  - the `top_k` request property default value changed from `10` to `10`
- **2026-08-17** `f54fa34db0f4` — 9 breaking, 9 warning, 3 info
  - request body became required
  - added `#/components/schemas/SearchOptions` to the `search_options` request property `allOf` list
  - added `#/components/schemas/SearchRerankConfig` to the `rerank_config` request property `allOf` list
  - the `agentic_rag_config` request property type/format changed from `object`/`` to ``/``
  - the `rerank_config` request property type/format changed from `object`/`` to ``/``
  - the `search_options` request property type/format changed from `object`/`` to ``/``
  - the `threshold` request property type/format changed from `number`/`` to `number`/`double`
  - the `top_k` request property type/format changed from `integer`/`` to `integer`/`int32`
  - the `matches/items/scores` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `agentic_rag_config/model`
  - removed the request property `rerank_config/model`
  - removed the request property `rerank_config/threshold`
  - removed the request property `rerank_config/top_k`
  - removed the request property `search_options/include_metadata`
  - removed the request property `search_options/include_scores`
  - removed the request property `search_options/include_vectors`
  - removed the optional property `matches/items/scores/rerank_score` from the response with the `200` status
  - removed the optional property `matches/items/scores/search_score` from the response with the `200` status
  - added the new optional request property `retrieval_config`
  - added `subschema #1, subschema #2` to the `agentic_rag_config` request property `anyOf` list
  - added `#/components/schemas/SearchKnowledgeScores` to the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-17** `ed68e8b009d7` — 8 breaking, 6 warning, 11 info
  - added the new required request property `agentic_rag_config/model`
  - added the new required request property `rerank_config/model`
  - removed `subschema #1, subschema #2` from the `agentic_rag_config` request property `anyOf` list
  - the `agentic_rag_config` request property type/format changed from ``/`` to `object`/``
  - the `rerank_config` request property type/format changed from ``/`` to `object`/``
  - the `search_options` request property type/format changed from ``/`` to `object`/``
  - the `matches/items/scores` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `matches/items/vector/items/` response's property type/format changed from `number`/`double` to `number`/`` for status `200`
  - removed `#/components/schemas/SearchOptions` from the `search_options` request property `allOf` list
  - removed `#/components/schemas/SearchRerankConfig` from the `rerank_config` request property `allOf` list
  - the `threshold` request property's max was set to `1.00`
  - the `top_k` request property's max was set to `100.00`
  - the `top_k` request property's min was set to `1.00`
  - removed the request property `retrieval_config`
  - added the new optional request property `rerank_config/threshold`
  - added the new optional request property `rerank_config/top_k`
  - added the new optional request property `search_options/include_metadata`
  - added the new optional request property `search_options/include_scores`
  - added the new optional request property `search_options/include_vectors`
  - request body became optional
  - the `threshold` request property type/format was generalized from `number`/`double` to `number`/``
  - the `top_k` request property type/format was generalized from `integer`/`int32` to `integer`/``
  - added the optional property `matches/items/scores/rerank_score` to the response with the `200` status
  - added the optional property `matches/items/scores/search_score` to the response with the `200` status
  - removed `#/components/schemas/SearchKnowledgeScores` from the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-17** `d46bd23ae34c` — 9 breaking, 9 warning, 3 info
  - request body became required
  - added `#/components/schemas/SearchOptions` to the `search_options` request property `allOf` list
  - added `#/components/schemas/SearchRerankConfig` to the `rerank_config` request property `allOf` list
  - the `agentic_rag_config` request property type/format changed from `object`/`` to ``/``
  - the `rerank_config` request property type/format changed from `object`/`` to ``/``
  - the `search_options` request property type/format changed from `object`/`` to ``/``
  - the `threshold` request property type/format changed from `number`/`` to `number`/`double`
  - the `top_k` request property type/format changed from `integer`/`` to `integer`/`int32`
  - the `matches/items/scores` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `agentic_rag_config/model`
  - removed the request property `rerank_config/model`
  - removed the request property `rerank_config/threshold`
  - removed the request property `rerank_config/top_k`
  - removed the request property `search_options/include_metadata`
  - removed the request property `search_options/include_scores`
  - removed the request property `search_options/include_vectors`
  - removed the optional property `matches/items/scores/rerank_score` from the response with the `200` status
  - removed the optional property `matches/items/scores/search_score` from the response with the `200` status
  - added the new optional request property `retrieval_config`
  - added `subschema #1, subschema #2` to the `agentic_rag_config` request property `anyOf` list
  - added `#/components/schemas/SearchKnowledgeScores` to the `matches/items/scores` response property `allOf` list for the response status `200`
- **2026-08-17** `f459ad9381eb` — 4 breaking, 1 info
  - the request property `search_type` became not nullable
  - the request property `threshold` became not nullable
  - the request property `top_k` became not nullable
  - removed the enum value `undefined` of the request property `search_type`
  - the `search_type` request property default value `hybrid_search` was added
- **2026-08-14** `deb8d376faee` — 5 info
  - the request property `search_type` became nullable
  - the request property `threshold` became nullable
  - the request property `top_k` became nullable
  - the `search_type` request property default value `hybrid_search` was removed
  - added the new `undefined` enum value to the request property `search_type`

---

[Operation](https://skmtc.dev/orq-ai/apis/orq-ai-api/docs/v2/knowledge/:knowledge_id/search/post.md) · [API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [Page](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/knowledge/:knowledge_id/search/post)
