---
title: "DELETE /users/{userId}/labels/{id}"
method: DELETE
path: "/users/{userId}/labels/{id}"
tags: ["users"]
---

# DELETE /users/{userId}/labels/{id}

`DELETE /users/{userId}/labels/{id}`

Immediately and permanently deletes the specified label and removes it from any messages and threads that it is applied to.

## Path parameters

- `userId` string, required
- `id` string, required

## Query parameters

- `$.xgafv` '1' | '2' — V1 error format
- `access_token` string
- `alt` 'json' | 'media' | 'proto' — Data format for response
- `callback` string
- `fields` string
- `key` string
- `oauth_token` string
- `prettyPrint` boolean
- `quotaUser` string
- `upload_protocol` string
- `uploadType` string

## Response `200`

Successful response

---

[API](https://skmtc.net/ballerina-platform/apis/gmail-api.md) · [All operations](https://skmtc.net/ballerina-platform/apis/gmail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ballerina-platform/gmail-api/versions/c7f11764507c/schema)