---
title: "Changes to Create an annotation queue"
method: POST
path: "/v2/annotation-queues"
---

# Changes to Create an annotation queue

`POST /v2/annotation-queues`

> Every recorded change to this operation, newest first.
> 49 revisions in range; 1 not diffed.

## Timeline

Changed in 3 of 49 revisions.

- **2026-09-09** `048cd28ee202`: 2 info
- **2026-08-20** `ddf93df2c295`: 2 info
- **2026-08-06** `4f94eb2fd1ab`: 9 breaking, 33 info

## Changes

- **2026-09-09** `048cd28ee202`: 2 info
  - added `SESSION` discriminator mapping keys to the `record_sources/items/` request property
  - added `#/components/schemas/AnnotationQueueSessionRecordInput` to the `record_sources/items/` request property `oneOf` list
- **2026-08-20** `ddf93df2c295`: 2 info
  - added the new optional request property `column_allowlist`
  - added the optional property `column_allowlist` to the response with the `201` status
- **2026-08-06** `4f94eb2fd1ab`: 9 breaking, 33 info
  - added `#/components/schemas/AssignmentMethod` to the `assignment_method` request property `allOf` list
  - removed the enum value `all` of the request property `assignment_method`
  - removed the enum value `example` of the request property `record_sources/items/oneOf[#/components/schemas/AnnotationQueueExampleRecordInput]/record_type`
  - removed the enum value `random` of the request property `assignment_method`
  - removed the enum value `span` of the request property `record_sources/items/oneOf[#/components/schemas/AnnotationQueueSpanRecordInput]/record_type`
  - the `assignment_method` request property type changed from `string` to no type
  - the `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - the `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - the `annotation_configs/items/oneOf[#/components/schemas/FreeformAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - api operation id `annotation_queues_create` removed and replaced with `create_annotation_queue`
  - the `assignment_method` request property default value changed from `all` to `ALL`
  - added `EXAMPLE, SPAN, TRACE` discriminator mapping keys to the `record_sources/items/` request property
  - removed `example, span` discriminator mapping keys from the `record_sources/items/` request property
  - added the new `EXAMPLE` enum value to the request property `record_sources/items/oneOf[#/components/schemas/AnnotationQueueExampleRecordInput]/record_type`
  - added the new `SPAN` enum value to the request property `record_sources/items/oneOf[#/components/schemas/AnnotationQueueSpanRecordInput]/record_type`
  - added `#/components/schemas/AnnotationQueueTraceRecordInput` to the `record_sources/items/` request property `oneOf` list
  - added the non-success response with the status `422`
  - added the optional property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/optimization_direction` to the response with the `201` status
  - added the optional property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/optimization_direction` to the response with the `201` status
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `annotation_configs/items/oneOf[#/components/schemas/FreeformAnnotationConfig]/` response property `allOf` list for the response status `201`
  - added `CONTINUOUS, CATEGORICAL, FREEFORM` discriminator mapping keys to the `annotation_configs/items/` response property for the response status `201`
  - removed `continuous, categorical, freeform` discriminator mapping keys from the `annotation_configs/items/` response property for the response status `201`
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/id` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/name` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/space_id` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/type` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/CategoricalAnnotationConfig]/values` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/id` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/maximum_score` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/minimum_score` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/name` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/space_id` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/ContinuousAnnotationConfig]/type` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/FreeformAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/FreeformAnnotationConfig]/id` to the response with the `201` status
  - added the required property `annotation_configs/items/oneOf[#/components/schemas/FreeformAnnotationConfig]/name` to the response with the `201` status
  - …2 more

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/annotation-queues/post.md) - [API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [Page](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/annotation-queues/post)