---
title: "Delete Label"
method: DELETE
path: "/labels/{id}"
tags: ["Label"]
---

# Delete Label

`DELETE /labels/{id}`

Permanently deletes a label from the caller's organization. This is a hard delete. References to the label from scorecard criteria and intelligence-item-collection criteria are not rewritten; callers that need a clean cascade should rename to a tombstone value first. Cross-organization deletes return 404.

## Path parameters

- `id` string, required

## Response `204`

Label successfully deleted. Response body is empty.

## Other responses

- `401` — Authentication failed. Please provide a valid organization-scoped API key.
- `404` — Label not found in the caller's organization
- `500` — Unexpected server error. Please try again later.
- `default` — Unexpected error occurred while deleting the label

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)