---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["users"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

Updates a section. Only sections of type `CUSTOM_SECTION` can be updated. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections`

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string
- `updateMask` string

## Request body

- GoogleChatV1Section — Represents a [section](https://support.google.com/chat/answer/16059854) in Google Chat. Sections help users organize their spaces. There are two types of sections: 1. **System Sections:** These are predefined sections managed by Google Chat. Their resource names are fixed, and they cannot be created, deleted, or have their `display_name` modified. Examples include: * `users/{user}/sections/default-direct-messages` * `users/{user}/sections/default-spaces` * `users/{user}/sections/default-apps` 2. **Custom Sections:** These are sections created and managed by the user. Creating a custom section using `CreateSection` **requires** a `display_name`. Custom sections can be updated using `UpdateSection` and deleted using `DeleteSection`.
  - `sortOrder` integer — Output only. The order of the section in relation to other sections. Sections with a lower `sort_order` value appear before sections with a higher value.
  - `name` string — Identifier. Resource name of the section. For system sections, the section ID is a constant string: - DEFAULT_DIRECT_MESSAGES: `users/{user}/sections/default-direct-messages` - DEFAULT_SPACES: `users/{user}/sections/default-spaces` - DEFAULT_APPS: `users/{user}/sections/default-apps` Format: `users/{user}/sections/{section}`
  - `type` 'SECTION_TYPE_UNSPECIFIED' | 'CUSTOM_SECTION' | 'DEFAULT_DIRECT_MESSAGES' | 'DEFAULT_SPACES' | 'DEFAULT_APPS' — Required. The type of the section.
  - `displayName` string — Optional. The section's display name. Only populated for sections of type `CUSTOM_SECTION`. Supports up to 80 characters. Required when creating a `CUSTOM_SECTION`.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/chat.md) · [All operations](https://skmtc.dev/google/apis/chat/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/chat/revisions/a57a778f1fcb/schema)