---
title: "Test one grounded answer against a private knowledge base"
method: POST
path: "/v1/knowledge-bases/{knowledge_base_id}/test"
---

# Test one grounded answer against a private knowledge base

`POST /v1/knowledge-bases/{knowledge_base_id}/test`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/knowledge-bases/{knowledge_base_id}/test`
- Auth: none declared

Customer-initiated only. The route binds the bearer organization/project and path base, reuses production passage retrieval, then asks Gemini for a short grounded preview. It returns exact visible source excerpts with an answer, explicit not_found when evidence is absent, or unavailable; it never creates a call, billing entry, retrieval event, action, or model-selectable scope.

## Path parameters

- `knowledge_base_id` string, required

## Request body

- KnowledgeBaseTest
  - `organization_id` string, required: Must match the bearer workspace.
  - `project_id` string, required: Must belong to the bearer workspace.
  - `question` string, required

## Response `200`

Grounded answer and source excerpts, explicit not_found, or safe unavailable outcome

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)