---
title: "Changes to Create an annotation config"
method: POST
path: "/v2/annotation-configs"
---

# Changes to Create an annotation config

`POST /v2/annotation-configs`

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

## Timeline

Changed in 1 of 48 revisions.

- **2026-08-06** `4f94eb2fd1ab`: 5 breaking, 30 info

## Changes

- **2026-08-06** `4f94eb2fd1ab`: 5 breaking, 30 info
  - added the new required request property `annotation_config_type`
  - removed `#/components/schemas/ContinuousAnnotationConfigCreate, #/components/schemas/CategoricalAnnotationConfigCreate, #/components/schemas/FreeformAnnotationConfigCreate` from the request body `oneOf` list
  - the `oneOf[#/components/schemas/CategoricalAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - the `oneOf[#/components/schemas/ContinuousAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - the `oneOf[#/components/schemas/FreeformAnnotationConfig]/` response's property type changed from no type to `object` for status `201`
  - api operation id `annotation_configs_create` removed and replaced with `create_annotation_config`
  - added `CONTINUOUS, CATEGORICAL, FREEFORM` mapping keys to the request discriminator
  - removed `continuous, categorical, freeform` mapping keys from the request discriminator
  - added `#/components/schemas/CreateContinuousAnnotationConfigRequest, #/components/schemas/CreateCategoricalAnnotationConfigRequest, #/components/schemas/CreateFreeformAnnotationConfigRequest` to the request body `oneOf` list
  - added `CONTINUOUS, CATEGORICAL, FREEFORM` mapping keys to the response discriminator for the response status `201`
  - removed `continuous, categorical, freeform` mapping keys from the response discriminator for the response status `201`
  - added the non-success response with the status `422`
  - added the optional property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/optimization_direction` to the response with the `201` status
  - added the optional property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/optimization_direction` to the response with the `201` status
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `oneOf[#/components/schemas/CategoricalAnnotationConfig]/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `oneOf[#/components/schemas/ContinuousAnnotationConfig]/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/AnnotationConfigBase, subschema #2` from the `oneOf[#/components/schemas/FreeformAnnotationConfig]/` response property `allOf` list for the response status `201`
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/name` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/space_id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/type` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/CategoricalAnnotationConfig]/values` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/maximum_score` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/minimum_score` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/name` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/space_id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/ContinuousAnnotationConfig]/type` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/FreeformAnnotationConfig]/created_at` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/FreeformAnnotationConfig]/id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/FreeformAnnotationConfig]/name` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/FreeformAnnotationConfig]/space_id` to the response with the `201` status
  - added the required property `oneOf[#/components/schemas/FreeformAnnotationConfig]/type` to the response with the `201` status

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/annotation-configs/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-configs/post)