Method: users.sections.patch

Updates a section. Only sections of type CUSTOM_SECTION can be updated. For details, see Create & organize sections in Google Chat.

Requires user authentication with the authorization scope:

  • https://www.googleapis.com/auth/chat.users.sections

HTTP request

PATCH https://chat.googleapis.com/v1/{section.name=users/*/sections/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
section.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}

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The mask to specify which fields to update.

Currently supported field paths:

  • displayName

Request body

The request body contains an instance of Section.

Response body

If successful, the response body contains an instance of Section.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chat.users.sections

For more information, see the Authorization guide.