> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getarca.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete label

> Permanently deletes a label from a workspace.

<Warning>This action is irreversible.</Warning>

<Info>
  Requires the `workspaces:write` scope. Only workspace owners and admins can delete labels.
</Info>

## Path parameters

<ParamField path="id" type="string" required>
  The numeric label ID.
</ParamField>

## Response

Returns `204 No Content` with an empty body on success.

<ResponseExample>
  ```204 No Content theme={null}
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "Only owners and admins can delete labels"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Label not found"
  }
  ```
</ResponseExample>