---
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.

Requires active subscription (paid/trial/dev) if Stripe is configured.

## Headers

- `workspace-key` string

## 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

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/arbicity/apis/arbi.md) · [All operations](https://skmtc.net/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arbicity/arbi/versions/1f956ac3d1c1/schema)