---
title: "Query an index"
method: POST
path: "/indexes/{indexName}/query"
---

# Query an index

`POST /indexes/{indexName}/query`

## Request body

- object
  - `query` string, required
  - `topK` integer
  - `alpha` number — 1.0 = pure semantic, 0.0 = pure keyword
  - `embedding` number[]
  - `filters` object

## Response `200`

Search results

- object
  - `docs` QueryResultDocumentInfo[]
    - `id` string, required
    - `text` string, required
    - `score` number, required
    - `metadata` object

---

[API](https://skmtc.dev/moss/apis/moss-control-plane-api.md) · [All operations](https://skmtc.dev/moss/apis/moss-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moss/moss-control-plane-api/revisions/95ef164ff2d7/schema)