---
title: "Changes to Query Sessions"
method: POST
path: "/sessions/query"
---

# Changes to Query Sessions

`POST /sessions/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 97 revisions.

- **2026-09-05** `9fe8525d5c27`: 1 info
- **2026-09-05** `2f5818dfac1f`: 2 info
- **2026-08-27** `713e4f3b7519`: 1 info
- **2026-08-14** `3ef89c8a67c5`: 3 info
- **2026-08-12** `d80e0b1da448`: 16 info
- **2026-08-09** `ea6421d829f1`: 2 info
- **2026-08-03** `fc532d6dc820`: 1 info

## Changes

- **2026-09-05** `9fe8525d5c27`: 1 info
  - added the optional property `sessions/items/capabilities` to the response with the `200` status
- **2026-09-05** `2f5818dfac1f`: 2 info
  - added the optional property `sessions/items/stopping_turn_id` to the response with the `200` status
  - added the optional property `sessions/items/turn_started_at` to the response with the `200` status
- **2026-08-27** `713e4f3b7519`: 1 info
  - added the new optional request property `archived_only`
- **2026-08-14** `3ef89c8a67c5`: 3 info
  - added the new optional request property `references/anyOf[subschema #1]/items/key`
  - added the new optional request property `turn_references/anyOf[subschema #1]/items/key`
  - added the optional property `sessions/items/references/anyOf[subschema #1]/items/key` to the response with the `200` status
- **2026-08-12** `d80e0b1da448`: 16 info
  - added the new optional request property `exclude`
  - added the new optional request property `exclude_origin`
  - added the new optional request property `exclude_session_ids`
  - added the new optional request property `expand`
  - added the new optional request property `flags`
  - added the new optional request property `include_total`
  - added the new optional request property `origin`
  - added the new optional request property `session`
  - added the new optional request property `session_ids`
  - added the new optional request property `turn_references`
  - added the optional property `sessions/items/delivery` to the response with the `200` status
  - added the optional property `sessions/items/last_message` to the response with the `200` status
  - added the optional property `sessions/items/origin` to the response with the `200` status
  - added the optional property `sessions/items/trigger` to the response with the `200` status
  - added the optional property `total` to the response with the `200` status
  - added the optional property `windowing` to the response with the `200` status
- **2026-08-09** `ea6421d829f1`: 2 info
  - added the new optional request property `search`
  - added the optional property `sessions/items/references` to the response with the `200` status
- **2026-08-03** `fc532d6dc820`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/agenta-ai/apis/agenta-api/docs/sessions/query/post.md) - [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/sessions/query/post)