---
title: "Changes to Query"
method: POST
path: "/agents/{agent_id}/query"
---

# Changes to Query

`POST /agents/{agent_id}/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 22 revisions.

- **2026-10-16** `4abdda722de9`: 1 info
- **2025-10-28** `c8152db45500`: 1 breaking, 3 info
- **2025-08-26** `db7245c74772`: 6 info
- **2025-05-08** `17bdb8a33fb4`: 2 info
- **2025-03-11** `194878b194cd`: 5 warning, 2 info
- **2025-02-26** `5298551c424b`: 2 warning, 1 info
- **2025-02-08** `d79ccb778953`: 2 warning, 2 info
- **2025-01-15** `4ed32c3243ce`: 1 warning, 1 info
- **2025-01-14** `4dd01a1cc34b`: 1 info

## Changes

- **2026-10-16** `4abdda722de9`: 1 info
  - added the new optional request property `override_configuration/use_optimized_context`
- **2025-10-28** `c8152db45500`: 1 breaking, 3 info
  - response property `retrieval_contents/items/custom_metadata/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - added the new optional request property `messages/items/custom_tags`
  - added the optional property `message/custom_tags` to the response with the `200` status
  - added the optional property `retrieval_contents/items/datastore_id` to the response with the `200` status
- **2025-08-26** `db7245c74772`: 6 info
  - added the new optional request property `override_configuration`
  - added the new `wildcard` enum value to the request property `documents_filters/anyOf[subschema #1: BaseMetadataFilter]/operator`
  - added the new `wildcard` enum value to the request property `documents_filters/anyOf[subschema #2: CompositeMetadataFilter]/filters/items/anyOf[subschema #1: BaseMetadataFilter]/operator`
  - added the optional property `retrieval_contents/items/ctxl_metadata` to the response with the `200` status
  - added the optional property `retrieval_contents/items/custom_metadata` to the response with the `200` status
  - added the optional property `retrieval_contents/items/custom_metadata_config` to the response with the `200` status
- **2025-05-08** `17bdb8a33fb4`: 2 info
  - added the new optional request property `structured_output`
  - added the optional property `retrieval_contents/items/score` to the response with the `200` status
- **2025-03-11** `194878b194cd`: 5 warning, 2 info
  - added the new `doc` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new `docx` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new `mhtml` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new `ppt` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new `pptx` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new optional request property `documents_filters`
  - added the optional property `groundedness_scores` to the response with the `200` status
- **2025-02-26** `5298551c424b`: 2 warning, 1 info
  - added the new `htm` enum value to the `retrieval_contents/items/format` response property for the response status `200`
  - added the new `knowledge` enum value to the `message/role` response property for the response status `200`
  - added the new `knowledge` enum value to the request property `messages/items/role`
- **2025-02-08** `d79ccb778953`: 2 warning, 2 info
  - removed the optional property `retrieval_contents/items/content` from the response with the `200` status
  - removed the optional property `retrieval_contents/items/extras` from the response with the `200` status
  - added the new optional `query` request parameter `include_retrieval_content_text`
  - added the optional property `retrieval_contents/items/content_text` to the response with the `200` status
- **2025-01-15** `4ed32c3243ce`: 1 warning, 1 info
  - removed the request property `model_id`
  - added the new optional request property `llm_model_id`
- **2025-01-14** `4dd01a1cc34b`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/contextualai/apis/endpoints/docs/agents/:agent_id/query/post.md) - [API](https://skmtc.dev/contextualai/apis/endpoints.md) - [Page](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/:agent_id/query/post)