---
title: "Changes to Create Annotation"
method: POST
path: "/annotations/"
---

# Changes to Create Annotation

`POST /annotations/`

> 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, 4 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/references/environment`
  - added the new optional request property `annotation/references/environment_revision`
  - added the new optional request property `annotation/references/environment_variant`
  - added the new optional request property `annotation/references/selector`
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_revision` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_variant` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/selector` to the response with the `200` status
- **2026-05-31** `c26abd89e092`: 8 warning
  - removed the request property `annotation/references/environment`
  - removed the request property `annotation/references/environment_revision`
  - removed the request property `annotation/references/environment_variant`
  - removed the request property `annotation/references/selector`
  - removed the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment` from the response with the `200` status
  - removed the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_revision` from the response with the `200` status
  - removed the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_variant` from the response with the `200` status
  - removed the optional property `annotation/anyOf[subschema #1: Annotation]/references/selector` from the response with the `200` status
- **2026-05-31** `06e03dbce2be`: 8 info
  - added the new optional request property `annotation/references/environment`
  - added the new optional request property `annotation/references/environment_revision`
  - added the new optional request property `annotation/references/environment_variant`
  - added the new optional request property `annotation/references/selector`
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_revision` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/references/environment_variant` to the response with the `200` status
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/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, 4 info
  - removed `subschema #1, subschema #2` from the `annotation/links` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `annotation/links` request property `anyOf` list
  - added the optional property `annotation/anyOf[subschema #1: Annotation]/attributes` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `annotation/anyOf[subschema #1: Annotation]/links` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `annotation/anyOf[subschema #1: Annotation]/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/post.md) - [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/annotations/post)