---
title: "Changes to Query Annotations"
method: POST
path: "/annotations/query"
---

# Changes to Query Annotations

`POST /annotations/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 97 revisions.

- **2026-06-01** `b2f21936417e`: 8 info
- **2026-05-31** `c26abd89e092`: 8 warning
- **2026-05-31** `06e03dbce2be`: 8 info
- **2026-05-19** `a7f9a6823230`: 2 warning
- **2026-05-08** `5e6f53ce5d08`: 1 info
- **2026-04-16** `8b06b786c977`: 1 breaking
- **2026-03-07** `20311f763505`: 1 breaking, 5 info
- **2026-02-27** `8fcd55a5a656`: 1 info
- **2025-06-27** `e3e84db47198`: 1 breaking

## Changes

- **2026-06-01** `b2f21936417e`: 8 info
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_revision`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_variant`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/selector`
  - added the optional property `annotations/items/references/environment` to the response with the `200` status
  - added the optional property `annotations/items/references/environment_revision` to the response with the `200` status
  - added the optional property `annotations/items/references/environment_variant` to the response with the `200` status
  - added the optional property `annotations/items/references/selector` to the response with the `200` status
- **2026-05-31** `c26abd89e092`: 8 warning
  - removed the request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment`
  - removed the request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_revision`
  - removed the request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_variant`
  - removed the request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/selector`
  - removed the optional property `annotations/items/references/environment` from the response with the `200` status
  - removed the optional property `annotations/items/references/environment_revision` from the response with the `200` status
  - removed the optional property `annotations/items/references/environment_variant` from the response with the `200` status
  - removed the optional property `annotations/items/references/selector` from the response with the `200` status
- **2026-05-31** `06e03dbce2be`: 8 info
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_revision`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/environment_variant`
  - added the new optional request property `annotation/anyOf[subschema #1: AnnotationQuery]/references/anyOf[subschema #1: SimpleTraceReferences]/selector`
  - added the optional property `annotations/items/references/environment` to the response with the `200` status
  - added the optional property `annotations/items/references/environment_revision` to the response with the `200` status
  - added the optional property `annotations/items/references/environment_variant` to the response with the `200` status
  - added the optional property `annotations/items/references/selector` 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-08** `5e6f53ce5d08`: 1 info
  - endpoint added
- **2026-04-16** `8b06b786c977`: 1 breaking
  - api path removed without deprecation
- **2026-03-07** `20311f763505`: 1 breaking, 5 info
  - removed `subschema #1, subschema #2` from the `annotation/anyOf[subschema #1: AnnotationQuery]/links` request property `anyOf` list
  - added the new optional request property `annotation_links/anyOf[subschema #1]/items/attributes`
  - added `subschema #1, subschema #2` to the `annotation/anyOf[subschema #1: AnnotationQuery]/links` request property `anyOf` list
  - added the optional property `annotations/items/attributes` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `annotations/items/links` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `annotations/items/links` response property `anyOf` list for the response status `200`
- **2026-02-27** `8fcd55a5a656`: 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/annotations/query/post.md) - [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/annotations/query/post)