---
title: "Query Conversation"
method: POST
path: "/v1/conversations/{conversation_id}/query"
tags: ["Conversations"]
---

# Query Conversation

`POST /v1/conversations/{conversation_id}/query`

## Request

- Base URL: `https://spss.insightgenius.io` (the document declares no server; this is the origin it was published from)
- URL: `https://spss.insightgenius.io/v1/conversations/{conversation_id}/query`
- Auth: none declared

Execute a natural language query against the project's data.

Pipeline:
1. Load conversation + project
2. Check cache
3. Interpret question (Claude → analysis plan)
4. Execute analyses (quantipy_engine)
5. Build response (NL + charts)
6. Persist messages
7. Return QueryResponse

## Path parameters

- `conversation_id` string, uuid, required

## Request body

- QueryRequest
  - `question` string, required
  - `segment_id` string, uuid, nullable
  - `filters` object[], nullable
  - `confidence_level` number, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api.md) · [All operations](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api/revisions/0d165df595f0?raw)