---
title: "Query Knowledge Bases"
method: POST
path: "/knowledge_bases/v2/query"
tags: ["Knowledge Bases V2"]
---

# Query Knowledge Bases

`POST /knowledge_bases/v2/query`

Query across one or more knowledge bases with unified results.

This endpoint consolidates results from multiple KBs into a single answer,
leveraging the consolidated workspace architecture for cross-workspace search.

Request body must include:
- question: The query to search for
- knowledge_base_ids: List of knowledge base IDs to query across

## Request body

- KnowledgeQueryRequest — Request for querying a knowledge base
  - `question` string, required
  - `knowledge_base_ids` integer[], required — List of knowledge base IDs to query across

## Response `200`

Successful Response

- KnowledgeQueryResponse — Response from querying a knowledge base
  - `answer` string, required
  - `chunks` ChunkReference[], nullable
    - `chunk_id` string, required
    - `relevance_score` number, required
    - `content` string, required
    - `file_path` string, nullable
    - `title` string, nullable
    - `chunk_order_index` integer, nullable
    - `metadata` object, nullable

## Other responses

- `403` — Access denied
- `404` — No accessible knowledge bases found
- `422` — Validation Error
- `500` — Query failed

---

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