---
title: "Update an annotation configuration"
method: PUT
path: "/v1/annotation_configs/{config_id}"
tags: ["annotation_configs"]
---

# Update an annotation configuration

`PUT /v1/annotation_configs/{config_id}`

## Path parameters

- `config_id` string, required — ID of the annotation configuration

## Request body

- union
  - CategoricalAnnotationConfigData
    - `name` string, required
    - `type` 'CATEGORICAL', required
    - `description` string, nullable
    - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE', required
    - `values` CategoricalAnnotationValue[], required
      - `label` string, required
      - `score` number, nullable
  - ContinuousAnnotationConfigData
    - `name` string, required
    - `type` 'CONTINUOUS', required
    - `description` string, nullable
    - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE', required
    - `lower_bound` number, nullable
    - `upper_bound` number, nullable
  - FreeformAnnotationConfigData
    - `name` string, required
    - `type` 'FREEFORM', required
    - `description` string, nullable
    - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE'
    - `threshold` number, nullable
    - `lower_bound` number, nullable
    - `upper_bound` number, nullable

## Response `200`

Successful Response

- UpdateAnnotationConfigResponseBody
  - `data` union, required
    - CategoricalAnnotationConfig
      - `name` string, required
      - `type` 'CATEGORICAL', required
      - `description` string, nullable
      - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE', required
      - `values` CategoricalAnnotationValue[], required
        - `label` string, required
        - `score` number, nullable
      - `id` string, required
    - ContinuousAnnotationConfig
      - `name` string, required
      - `type` 'CONTINUOUS', required
      - `description` string, nullable
      - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE', required
      - `lower_bound` number, nullable
      - `upper_bound` number, nullable
      - `id` string, required
    - FreeformAnnotationConfig
      - `name` string, required
      - `type` 'FREEFORM', required
      - `description` string, nullable
      - `optimization_direction` 'MINIMIZE' | 'MAXIMIZE' | 'NONE'
      - `threshold` number, nullable
      - `lower_bound` number, nullable
      - `upper_bound` number, nullable
      - `id` string, required

## Other responses

- `403` — Forbidden
- `422` — Validation Error

---

[API](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/versions/a14d8ad6f708/schema)