---
title: "Permanently delete a Gmail user label"
method: DELETE
path: "/v1/capabilities/google-workspace/gmail-label/{labelId}"
tags: ["Capability Sources"]
---

# Permanently delete a Gmail user label

`DELETE /v1/capabilities/google-workspace/gmail-label/{labelId}`

Permanently removes the user label and its assignment from every message and thread, without deleting the messages. Reads its type first and refuses system labels. Requires gmail.labels or gmail.modify and explicit user confirmation. Uses only the calling member's selected connected Google account. Perform writes only when explicitly requested by the user; capability discovery or selection is not authorization. Never automatically retry an uncertain write.

## Path parameters

- `labelId` string, required

## Request body

- object
  - `confirm` true, required — True only when the user explicitly requested this action on this resource. Discovering or selecting a capability is not authorization.

## Response `200`

Google's validated response.

- object
  - `ok` true, required

## Other responses

- `400` — Invalid input.
- `401` — Sign-in required.
- `409` — Missing permission or protected system label.
- `413` — Request exceeds 6 MiB.
- `502` — Google rejected or did not confirm the operation.

## Changes

- **2026-09-10** `7d79c843d137` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/capabilities/google-workspace/gmail-label/:labelId/delete.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) · [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/7d79c843d137?raw)