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

# POST /v2/{+name}:publish

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

Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.

## Path parameters

- `name` string, required

## Request body

- GoogleAppsDriveLabelsV2PublishLabelRequest — Request to publish a 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.
  - `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.

## 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/revisions/0865f97e9c4a/schema)