---
title: "Knowledge RAG query (external MCP + local tenant index)"
method: POST
path: "/api/knowledge-rag/query"
tags: ["Knowledge RAG"]
---

# Knowledge RAG query (external MCP + local tenant index)

`POST /api/knowledge-rag/query`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/knowledge-rag/query`
- Auth: none declared

## Query parameters

- `token` string

## Request body

- object
  - `queryType` 'semantic' | 'scroll' | 'fetch' | 'collection_info'
  - `query` string
  - `limit` number
  - `scoreThreshold` number
  - `dedupe` boolean
  - `rerank` boolean
  - `diversityPerDocument` number
  - `rerankWindow` number: Default: max(30, min(limit * 4, 50))
  - `ids` union[]
    - union
      - string
      - number
  - `offset` union
    - string
    - number
    - object
  - `filter` object
  - `withPayload` boolean
  - `withVectors` boolean
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

RAG query result (internal/direct calls only; external callers receive 202)

- object
  - `success` boolean
  - `data` object
    - `queryType` string
    - `collection` string
    - `returned` number
    - `results` object[]
      - `pointId` string
      - `score` number
      - `referenceText_L0` string
      - `vectorText` string
      - `metadata` object
        - `title` string
        - `docType` string
        - `authority` string
        - `status` string
      - `oeoTags` string[]

## Other responses

- `202`: Job accepted and queued for async processing

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)