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

# Delete label

`DELETE /v1/labels/{labelName}`

Delete a label from the organization.

Any user can delete basic labels, but **Organization Admin** permissions are required to delete **Verified** and **Homepage** labels.

## Path parameters

- `name` string, required

## Query parameters

- `userId` string

## Response `204`

Label deleted successfully. No response body.

## Other responses

- `403` — Forbidden. Possible causes: - User lacks permission to manage labels - User lacks **Organization Admin** permissions, which are required to delete **Verified** labels - User lacks **Organization Admin** permissions, which are required to delete **Homepage** labels
- `404` — Label not found
- `409` — Conflict. The label is currently applied to documents and cannot be deleted. Remove the label from all documents first.
- `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)