Base URL: https://app.dmu.email/api/v1
Authentication: Bearer dmk_… API key
Rate limit: 120 requests a minute per key

Delete a label

DELETE/labels/{id}

Takes a label off every conversation that carries it, then deletes it.

Needs the permissionlabels:delete

The labels inside it move up a level by default, to the deleted label’s own parent, and keep their conversations. With ?inside=delete they’re deleted too.

Members who may manage labels can delete only labels no conversation carries, and with inside=delete that goes for every label deleted: if one is in use, nothing is deleted. Administrators can delete any.

Path parameters

idstringrequired: The label.

Query parameters

insidestringoptional: What happens to the labels inside it: keep (the default) or delete.

Returns

Nothing: a successful delete is 204 No Content.

Errors

400invalid_request: inside isn’t keep or delete.
401invalid_key: The key is wrong, expired or revoked. With no Authorization header at all, the code is missing_credentials.
403missing_scope: The key doesn’t have labels:delete. The X-Required-Scope header names what’s missing.
403in_use: The key’s owner is a member and conversations carry a label that would be deleted.
403not_allowed: The key’s owner isn’t allowed to manage labels in this organisation.
404not_found: There’s no such label, or the key’s owner can’t see it.
409move_clash: A label inside it would move up beside another with the same name. Rename one first, or send inside=delete.
429rate_limited: More than 120 requests a minute from this key. Wait for Retry-After seconds.

curl https://app.dmu.email/api/v1/labels/e2a4f809 \
  -X DELETE \
  -H "Authorization: Bearer dmk_7f3a9c2e1b4d_Xq8v…"

Response

204 No Content

No body.

A 204 has no body, so there’s no data to unwrap.