Query an unstructured knowledge base

POST 
/ai/knowledgebases/:id/query

Vector-retrieves relevant chunks and generates an answer. Unstructured knowledge bases only. Structured knowledge bases are not queried on this path (they have no embedding model and this handler does not call the structured retrieve-and-generate flow). Requires at least read-only access. modelId must be a TEXT model assigned to knowledge bases. Optional SourceId (Bedrock data source ID) and FileName (source URI) scope retrieval. Citations are not returned on this REST path. Fails if no sources are attached or the embedding model is not assigned.

Request

Responses

200

Answer plus ChunksRetrieved. GuardRailIntervention fields are included when the model returns. Metrics is included when present on the model response. ChunksRetrieved is empty when no accessible content is found or a guard rail blocks the answer.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1002 (KB not found or no sources attached), AI-1009 (embedding model not assigned), IPV-1008 (invalid modelId), AUTH-1012 (insufficient access), AUTH-1001 (missing role_id), AUTH-1011 (caller not authorized).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1085 (unexpected backend failure), DB-1002 (persistence failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers