---
title: "Changes to Query"
method: POST
path: "/api/assistant/query"
---

# Changes to Query

`POST /api/assistant/query`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 34 revisions.

- **2026-01-21** `1f956ac3d1c1` — 2 info
- **2025-10-28** `849d5e8732f6` — 3 info
- **2025-10-06** `8d3e894e6c0b` — 6 breaking
- **2025-08-21** `84efd317dcde` — 1 breaking
- **2025-08-19** `5287337ab0fe` — 1 info
- **2025-08-06** `43c12480eb1b` — 2 breaking, 6 warning, 2 info

## Changes

- **2026-01-21** `1f956ac3d1c1` — 2 info
  - added the new optional request property `tools/additionalProperties/oneOf[subschema #2: RetrievalChunkTool]/tool_responses/additionalProperties/items/metadata/heading`
  - added the new optional request property `tools/additionalProperties/oneOf[subschema #3: RetrievalFullContextTool]/tool_responses/additionalProperties/items/metadata/heading`
- **2025-10-28** `849d5e8732f6` — 3 info
  - added the new optional `header` request parameter `workspace-key`
  - added `trace` discriminator mapping keys to the `tools/additionalProperties/` request property
  - added `#/components/schemas/TraceTool` to the `tools/additionalProperties/` request property `oneOf` list
- **2025-10-06** `8d3e894e6c0b` — 6 breaking
  - added the new required request property `tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/chunk_ids`
  - added the new required request property `tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/offset_end`
  - added the new required request property `tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/offset_start`
  - added the new required request property `tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/statement`
  - the `tools/additionalProperties/oneOf[subschema #1: ModelCitationTool]/tool_responses/additionalProperties/` request property type/format changed from `array`/`` to `object`/``
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
- **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`
  - removed the request property `tools/additionalProperties/description`
  - removed the request property `tools/additionalProperties/name`
  - removed the request property `tools/additionalProperties/tool_args`
  - removed the request property `tools/additionalProperties/tool_responses`
  - added discriminator to `tools/additionalProperties/` request property
  - added `#/components/schemas/ModelCitationTool, #/components/schemas/RetrievalChunkTool-Input, #/components/schemas/RetrievalFullContextTool-Input` to the `tools/additionalProperties/` request property `oneOf` list

---

[Operation](https://skmtc.dev/arbicity/apis/arbi/docs/api/assistant/query/post.md) · [API](https://skmtc.dev/arbicity/apis/arbi.md) · [Page](https://skmtc.dev/arbicity/apis/arbi/changes/api/assistant/query/post)