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

# Delete a label

`DELETE /api/v1/labels/{name}`

## Path parameters

- `name` string, required — Label name

## Query parameters

- `userId` string, uuid — Target user membership ID (for org-scoped API keys)

## Response `204`

Label deleted successfully

## Other responses

- `401` — Authentication required
- `403` — Permission denied - cannot delete verified/homepage labels without admin permissions
- `404` — Label not found
- `409` — Cannot delete label that is applied to documents

---

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