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

# Delete Label Assignment

`DELETE /v0/platform/labels/{id}`

## Request

- Base URL: `https://api.blockaid.io`
- URL: `https://api.blockaid.io/v0/platform/labels/{id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-CLIENT-ID`
- TypeScript: <https://skmtc.dev/blockaid-official/apis/blockaid-api/docs/v0/platform/labels/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a specific label assignment by ID. Returns 404 if the ID does not exist or belongs to another organization.

## Path parameters

- `id` string, uuid, required: Label assignment ID.

## Response `204`

Label removed. No response body. Note: this operation is non-idempotent — if the assignment does not exist (already deleted or never applied), the response is 404, not 204.

## Other responses

- `404`: Label assignment not found
- `422`: Validation Error
- `502`: The label classifier service is unavailable. The label was not changed. Retry the request.

## Changes

> 120 revisions in range; 1 not diffed.

- **2026-10-29** `930364a79482`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/blockaid-official/apis/blockaid-api/changes/v0/platform/labels/:id/delete.md)

---

[API](https://skmtc.dev/blockaid-official/apis/blockaid-api.md) - [All operations](https://skmtc.dev/blockaid-official/apis/blockaid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockaid-official/apis/blockaid-api/revisions/104550c9d3f1?raw)
