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

# Query Knowledge Bases

`POST /knowledge_bases/v2/query`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/knowledge_bases/v2/query`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)