---
title: "Changes to Query Spans"
method: POST
path: "/spans/query"
---

# Changes to Query Spans

`POST /spans/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 97 revisions.

- **2026-10-15** `4935907204a4`: 1 info
- **2026-08-03** `fc532d6dc820`: 3 info
- **2026-05-19** `a7f9a6823230`: 2 warning
- **2026-05-07** `dc41a70e3ad8`: 3 breaking, 3 info
- **2026-05-02** `6e37373d45fe`: 2 info
- **2026-04-23** `925e8b901a26`: 2 info
- **2026-04-18** `c469c2f6cdba`: 1 info
- **2025-06-27** `e3e84db47198`: 1 breaking

## Changes

- **2026-10-15** `4935907204a4`: 1 info
  - added the optional property `windowing` to the response with the `200` status
- **2026-08-03** `fc532d6dc820`: 3 info
  - added the optional property `spans/anyOf[subschema #1]/items/agent_id` to the response with the `200` status
  - added the optional property `spans/anyOf[subschema #1]/items/session_id` to the response with the `200` status
  - added the optional property `spans/anyOf[subschema #1]/items/user_id` to the response with the `200` status
- **2026-05-19** `a7f9a6823230`: 2 warning
  - removed the optional property `support_id` from the response with the `200` status
  - removed the optional property `support_ts` from the response with the `200` status
- **2026-05-07** `dc41a70e3ad8`: 3 breaking, 3 info
  - removed `#/components/schemas/agenta__sdk__models__shared__Reference` from the `query_ref` request property `anyOf` list
  - removed `#/components/schemas/agenta__sdk__models__shared__Reference` from the `query_revision_ref` request property `anyOf` list
  - removed `#/components/schemas/agenta__sdk__models__shared__Reference` from the `query_variant_ref` request property `anyOf` list
  - added `#/components/schemas/Reference` to the `query_ref` request property `anyOf` list
  - added `#/components/schemas/Reference` to the `query_revision_ref` request property `anyOf` list
  - added `#/components/schemas/Reference` to the `query_variant_ref` request property `anyOf` list
- **2026-05-02** `6e37373d45fe`: 2 info
  - api tag `Traces` added
  - api tag `Observability` removed
- **2026-04-23** `925e8b901a26`: 2 info
  - added the optional property `support_id` to the response with the `200` status
  - added the optional property `support_ts` to the response with the `200` status
- **2026-04-18** `c469c2f6cdba`: 1 info
  - endpoint added
- **2025-06-27** `e3e84db47198`: 1 breaking
  - api path removed without deprecation

---

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