---
title: "POST /v2/{+name}:disable"
method: POST
path: "/v2/{+name}:disable"
tags: ["labels"]
---

# POST /v2/{+name}:disable

`POST /v2/{+name}:disable`

Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.

## Path parameters

- `name` string, required

## Request body

- GoogleAppsDriveLabelsV2DisableLabelRequest — Request to deprecate a published label.
  - `writeControl` GoogleAppsDriveLabelsV2WriteControl — Provides control over how write requests are executed. When not specified, the last write wins.
    - `requiredRevisionId` string — The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
  - `languageCode` string — The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.
  - `updateMask` string, google-fieldmask — The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.
  - `useAdminAccess` boolean — Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
  - `disabledPolicy` GoogleAppsDriveLabelsV2LifecycleDisabledPolicy — The policy that governs how to treat a disabled label, field, or selection choice in different contexts.
    - `showInApply` boolean — Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.
    - `hideInSearch` boolean — Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/drivelabels.md) · [All operations](https://skmtc.net/google/apis/drivelabels/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/drivelabels/versions/0865f97e9c4a/schema)