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

# Delete an annotation configuration

`DELETE /v1/annotation_configs/{config_id}`

## Path parameters

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

## Response `200`

Successful Response

- DeleteAnnotationConfigResponseBody
  - `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

## Changes

- **2026-07-17** `5b062a93db67` — 1 info
  - api operation id `delete_annotation_config_v1_annotation_configs__config_id__delete` removed and replaced with `deleteAnnotationConfig`
- **2026-05-21** `ea31306c1333` — 4 info
  - added the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/lower_bound` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/optimization_direction` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/threshold` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/upper_bound` to the response with the `200` status
- **2026-04-29** `c81391216eb5` — 4 warning
  - removed the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/lower_bound` from the response with the `200` status
  - removed the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/optimization_direction` from the response with the `200` status
  - removed the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/threshold` from the response with the `200` status
  - removed the optional property `data/oneOf[subschema #3: FreeformAnnotationConfig]/upper_bound` from the response with the `200` status

[Change history](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/annotation_configs/:config_id/delete.md)

---

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