---
title: "Update a dataset label by ID"
method: PATCH
path: "/v1/dataset_labels/{label_id}"
tags: ["datasets"]
---

# Update a dataset label by ID

`PATCH /v1/dataset_labels/{label_id}`

Partially update a dataset label's name, color, and/or description. Only the fields included in the request body are changed; omitted fields are left as-is.

## Path parameters

- `label_id` string, required — The ID of the dataset label

## Request body

- UpdateDatasetLabelRequestBody — Fields to update on a dataset label. Omit a field to leave it unchanged.
  - `name` string, nullable — New name for the label (null is rejected; name is required)
  - `color` string, nullable — A lowercase six-digit hex color code (e.g. '#00cc88')
  - `description` string, nullable — New description for the label (null clears the description)

## Response `200`

Successful Response

- UpdateDatasetLabelResponseBody
  - `data` DatasetLabel, required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `color` string, required

## Other responses

- `403` — Forbidden
- `404` — Dataset label not found
- `409` — A dataset label with the same name already exists
- `422` — Invalid dataset label ID or request body

---

[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)