---
title: "Update label"
method: PUT
path: "/v1/labels/{labelName}"
tags: ["Labels"]
---

# Update label

`PUT /v1/labels/{labelName}`

Update an existing label, including renaming, changing **Verified** status, or adding/removing it from the **Homepage**.

Users can update basic labels they created. **Organization Admin** permissions are required to modify **Verified** or **Homepage** labels, including making a label `verified` or visible on the `homepage`.

## Path parameters

- `name` string, required

## Query parameters

- `userId` string

## Request body

- object
  - `name` string — The new name of the label.
  - `verified` boolean — **Organization Admin permissions required**. If `true`, documents with the label will be marked as **Verified**.
  - `homepage` boolean — **Organization Admin permissions required**. If `true`, documents with the label will be visible on the **Homepage**.
  - `color` string — Hex color for the label
  - `description` string — Description of the label

## Response `200`

Label updated successfully

- Label — A label for organizing and categorizing documents and folders
  - `name` string — The label name (2-25 characters). Names are case-insensitive: `"Production"` and `"production"` are considered the same.
  - `verified` boolean — Whether the label is verified/curated
  - `homepage` boolean — Whether the label appears on the organization homepage
  - `usage_count` integer — Total number of documents and folders using this label
  - `color` string — Hex color for the label
  - `description` string — Description of the label

## Other responses

- `400` — Bad Request. Possible causes: - Name too short or too long
- `403` — Forbidden. Possible causes: - User lacks permission to manage labels - User lacks **Organization Admin** permissions, which are required to modify **Verified** labels - User lacks **Organization Admin** permissions, which are required to modify **Homepage** labels
- `404` — Label not found
- `409` — Conflict. The new label name already exists (case-insensitive).
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)