:::endpoint DELETE /v1/me/mail/labels/{id}

The rows tying the label to messages go with it. The mail does not.

A label is a way of finding messages, never a place they live, so removing one
can never lose anything. That is what makes this different from deleting a
folder, and why there is no undo and no bin.

:::warning It disappears for everyone
Labels belong to the environment. Deleting one takes it off every conversation
it was on, for every colleague, immediately.
:::

Anything still filtering on the id afterwards gets a `404` from
[the message list](/docs/api/mail/messages) rather than the whole folder back.

## Request

```bash
curl -X DELETE https://api.proppertrading.com/v1/me/mail/labels/10 \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"
```

## Response

`204`, with no body.

## Errors

| Status | Code                 | Meaning                                   |
| ------ | -------------------- | ----------------------------------------- |
| 403    | `insufficient_scope` | This device does not hold `mail:write`    |
| 404    | `resource_not_found` | No label with that id in this environment |