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

# Query

`POST /api/assistant/query`

Process a user query against documents in a workspace.
Performs retrieval augmented generation with streaming response.

## Request body

- MessageInput
  - `content` string, required
  - `tools` object
  - `workspace_ext_id` string, required
  - `parent_message_ext_id` string, nullable
  - `config_ext_id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-21** `84efd317dcde` — 1 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
- **2025-08-19** `5287337ab0fe` — 1 info
  - added the new optional request property `config_ext_id`
- **2025-08-06** `43c12480eb1b` — 2 breaking, 6 warning, 2 info
  - added the pattern `^wrk-[a-zA-Z0-9]{8}$` to the request property `workspace_ext_id`
  - the `tools/additionalProperties/` request property type/format changed from `object`/`` to ``/``
  - removed the request property `model`
  - removed the request property `system_message`
  - …6 more

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/assistant/query/post.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/84efd317dcde/schema)