---
title: "Query"
method: POST
path: "/v1/query"
tags: ["query"]
---

# Query

`POST /v1/query`

## Request body

- QueryRequest
  - `workspace_id` string, uuid, required
  - `prompt` string, required
  - `vault_ids` string[], nullable
  - `depth` integer
  - `top_k_chunks` integer
  - `include_deals` boolean
  - `include_meetings` boolean
  - `include_claims` boolean

## Response `200`

Successful Response

- QueryResponse
  - `answer` string, required
  - `citations` Citation[], required
    - `url` string, nullable
    - `title` string, nullable
    - `quote` string, nullable
    - `document_id` string, nullable
    - `chunk_id` string, nullable
    - `source_type` string, nullable
  - `entities_mentioned` EntityRef[]
    - `key` string, required
    - `name` string, required
    - `type` string, required
  - `related_deals` DealRef[]
    - `key` string, required
    - `name` string, required
    - `stage` string, nullable
    - `amount` number, nullable
    - `account_name` string, nullable
  - `related_meetings` MeetingRef[]
    - `key` string, required
    - `title` string, required
    - `scheduled_start` string, nullable
    - `attendee_count` integer
  - `claims_used` ClaimRef[]
    - `key` string, required
    - `claim_text` string, required
    - `claim_type` string, required
    - `about_entity` string, nullable
  - `debug` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)