> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat

> Google Chat API integration for messaging and collaboration in Google Workspace

![Google Chat logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/google_chat.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=1c39799bb3c8d38c3821b067eb9466cd)

* **Category:** productivity
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 46
* **Triggers:** 0
* **Slug:** `GOOGLE_CHAT`
* **Version:** 20261101\_00

## Tools

> [accordion] Complete Space Import
>
> **Slug:** `GOOGLE_CHAT_COMPLETE_IMPORT`
>
> Completes the import process for an import-mode Google Chat space and makes it visible to users. Use this action at the end of a data migration into Google Workspace, after all messages and memberships have been imported into a space that was created with `importMode: true`. Requires user authentication with domain-wide delegation (service-account flow) and the `chat.import` OAuth scope. Cannot be called with regular user OAuth.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the import-mode space to finalize. Format: `spaces/{space}`. The space must have been created with `importMode: true` and the import must be complete before calling this.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Custom Emoji
>
> **Slug:** `GOOGLE_CHAT_CREATE_CUSTOM_EMOJI`
>
> Creates a custom emoji in Google Chat for use within a Google Workspace organization. An administrator must enable custom emojis for the organization.
>
> #### Input Parameters
>
> **payload** `object` *required*
>
> The image payload for the custom emoji.
>
> **emoji\_name** `string` *required*
>
> User-provided name for the emoji. Must be unique within the organization. Must start and end with colons (:), contain only lowercase letters, numbers, hyphens, and underscores. Example: ':party-emoji:'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Space Member
>
> **Slug:** `GOOGLE_CHAT_CREATE_MEMBER`
>
> Creates a membership for a user, Chat app, or Google Group in a space. When creating a membership, if the member has auto-accept turned off, they're invited and must accept the invitation before joining. Use this action when you need to add a new member to a Google Chat space. This can be used to invite individual users, add Chat apps, or add Google Groups to a space. If the member requires acceptance, they will receive an invitation. Note: `parent` must be the resource name of a space that already exists - this action does not create one. To start a new direct message with a user, use GOOGLE\_CHAT\_SET\_UP\_SPACE instead, which creates the DM space and adds the member in one call. Note: App authentication cannot add users external to the Workspace organization, add Google Groups, or add Chat apps to a space.
>
> #### Input Parameters
>
> **member** `object`
>
> The member to add to the space (used in request body).
>
> **parent** `string` *required*
>
> Required. The resource name of the space to create the membership in. Format: `spaces/{space}`.
>
> **groupMember** `object`
>
> Represents a Google Group in Google Chat.
>
> **useAdminAccess** `boolean`
>
> Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. Requires the `chat.admin.memberships` scope.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Message
>
> **Slug:** `GOOGLE_CHAT_CREATE_MESSAGE`
>
> Creates a message with text or cards in an existing Google Chat space, up to 32,000 bytes, or replies to a thread. Named-thread replies default to failing if the thread is missing; use GOOGLE\_CHAT\_SET\_UP\_SPACE to create a direct-message space first.
>
> #### Input Parameters
>
> **text** `string`
>
> Plain-text body of the message. With user authentication, this is the only supported field. Maximum message size is 32,000 bytes. You can mention users by using '@user' syntax.
>
> **parent** `string` *required*
>
> Resource name of the space to create the message in. Format: 'spaces/\{space}'.
>
> **cards\_v2** `array`
>
> Rich card UI elements (bot authentication only). For user authentication, only text messages are supported.
>
> **message\_id** `string`
>
> Optional. A custom ID for the message. Lets Chat apps get, update, or delete the message without storing its system-assigned ID. Must start with `client-` and contain only lowercase letters, numbers, and hyphens (max 63 chars).
>
> **request\_id** `string`
>
> Optional. A unique request ID. Specifying an existing request ID returns the message created with that ID instead of creating a new one. A random UUID is recommended.
>
> **thread\_key** `string`
>
> Client-generated thread key for threads created by the calling Chat app. Google Chat only uses the key when message\_reply\_option is set: with either option, the message joins the thread for this key, or starts a new thread if the key is unused. Without message\_reply\_option, every message starts a new thread even if the key was used before. This key is unique per Chat app. Do not combine with thread\_name.
>
> **thread\_name** `string`
>
> Resource name of an existing thread, including threads created by people or other Chat apps. Format: 'spaces/\{space}/threads/\{thread}'. Use the thread.name returned by GOOGLE\_CHAT\_LIST\_MESSAGES. Do not combine with thread\_key. When message\_reply\_option is omitted, defaults to REPLY\_MESSAGE\_OR\_FAIL so a missing thread does not start a new conversation.
>
> **notification\_type** `string ("NOTIFICATION_TYPE_NONE" | "NOTIFICATION_TYPE_FORCE_NOTIFY" | "NOTIFICATION_TYPE_SILENT")`
>
> Notification behavior when a message is posted.
>
> **message\_reply\_option** `string ("REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD" | "REPLY_MESSAGE_OR_FAIL")`
>
> Whether to reply to an existing thread or fail if none exists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Reaction
>
> **Slug:** `GOOGLE_CHAT_CREATE_REACTION`
>
> Creates an emoji reaction on a Google Chat message. Use this action when you need to add an emoji reaction (like 👍, ❤️, or 🎉) to an existing message in a Google Chat space. Either emoji\_unicode or emoji\_custom\_id is required, but not both. This action is useful for acknowledging messages, voting on ideas, expressing emotions in response to messages, or building interactive message features in Google Chat bots.
>
> #### Input Parameters
>
> **parent** `string` *required*
>
> Resource name of the message to react to. Format: 'spaces/\{space}/messages/\{message}'.
>
> **emoji\_unicode** `string`
>
> Unicode emoji to use for the reaction (e.g., '👍', '❤️', '🎉'). Either emoji\_unicode or emoji\_custom\_id is required.
>
> **emoji\_custom\_id** `string`
>
> Resource name of a custom emoji to use for the reaction. Format: 'spaces/\{space}/customEmojis/\{custom\_emoji}'. Either emoji\_unicode or emoji\_custom\_id is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create section
>
> **Slug:** `GOOGLE_CHAT_CREATE_SECTION`
>
> Creates a custom section in Google Chat for organizing conversations in the navigation panel. Use when you need to create a new custom section to organize spaces and direct messages in the user's Chat sidebar.
>
> #### Input Parameters
>
> **type** `string ("CUSTOM_SECTION")` *required*
>
> Required. The type of the section to create. Only CUSTOM\_SECTION can be created; DEFAULT\_\* sections are system-managed.
>
> **parent** `string` *required*
>
> Required. The user identifier. Use 'me' for the authenticated user or a specific user ID.
>
> **display\_name** `string` *required*
>
> Required. The section's display name. Max 80 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Space
>
> **Slug:** `GOOGLE_CHAT_CREATE_SPACE`
>
> Creates a named space in Google Chat. The calling user is automatically added as a member and space manager. For a group chat or direct message, use GOOGLE\_CHAT\_SET\_UP\_SPACE instead. Use this action when you need to create a discoverable named space for team collaboration or project discussions. For group conversations without a named space, use GOOGLE\_CHAT\_SET\_UP\_SPACE. Note: If you receive the error ALREADY\_EXISTS when creating a space, try a different displayName. The displayName must be unique within the organization.
>
> #### Input Parameters
>
> **requestId** `string`
>
> Optional. A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space. Specifying an existing request ID from the same Chat app with a different authenticated user returns an error.
>
> **spaceType** `string ("SPACE")` *required*
>
> The type of space to create. Must be SPACE. For GROUP\_CHAT or DIRECT\_MESSAGE, use the GOOGLE\_CHAT\_SET\_UP\_SPACE action instead.
>
> **description** `string`
>
> A description of the space. Helps users understand the space's purpose. Supports up to 150 characters.
>
> **displayName** `string` *required*
>
> Required. The display name of the space. Max 128 characters. Must be unique within the organization (an ALREADY\_EXISTS error is returned if the name is taken).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Custom Emoji
>
> **Slug:** `GOOGLE_CHAT_DELETE_CUSTOM_EMOJI`
>
> Deletes a custom emoji from Google Chat. By default, users can only delete custom emojis they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. Use this action when you need to permanently remove a custom emoji that is no longer needed. This action is irreversible — once deleted, the custom emoji cannot be recovered.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the custom emoji to delete. Format: customEmojis/\{customEmoji}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Member from Space
>
> **Slug:** `GOOGLE_CHAT_DELETE_MEMBER`
>
> Removes a user, Google Group, or app membership from a Google Chat space using its membership resource name. The request can use Google Workspace administrator privileges when authorized. A membership that is not found is reported as an error.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the membership to delete. Format: spaces/\{space}/members/\{member}. You can get this value from the spaces.members.list response or from the spaces.get response.
>
> **use\_admin\_access** `boolean`
>
> When true, requests will be made using Google Workspace administrator privileges. The authenticated user must be a Google Workspace administrator. Optional.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Message
>
> **Slug:** `GOOGLE_CHAT_DELETE_MESSAGE`
>
> Deletes a message from a Google Chat space; with user authentication, the force option can also delete its threaded replies. Deletion is irreversible, and permitted actions depend on the caller's authentication and permissions.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the message to delete. Format: spaces/\{space}/messages/\{message}. Custom IDs from clientAssignedMessageId field are supported.
>
> **force** `boolean`
>
> When true, deletes the message and all its threaded replies. When false, deletion fails if threaded replies exist. Only applies to user authentication. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Reaction
>
> **Slug:** `GOOGLE_CHAT_DELETE_REACTION`
>
> Deletes a reaction to a message. Use when you need to remove a reaction that was previously added to a message. Users can only delete their own reactions. This action is irreversible — once the reaction is deleted, it cannot be recovered.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. The resource name of the reaction to delete. Format: spaces/\{space}/messages/\{message}/reactions/\{reaction}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete section
>
> **Slug:** `GOOGLE_CHAT_DELETE_SECTION`
>
> Deletes a custom section from Google Chat by its ID. This action is irreversible — once a section is deleted, it cannot be recovered. If the section contains items (such as spaces), they are moved to Google Chat's default sections and are not deleted. Use when you need to remove a custom section that is no longer needed.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The user ID of the user who owns the section. Use 'me' for the authenticated user.
>
> **section\_id** `string` *required*
>
> The unique ID of the section to delete. Section IDs can be obtained from list sections actions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete space
>
> **Slug:** `GOOGLE_CHAT_DELETE_SPACE`
>
> Deletes a named space from Google Chat. Always performs a cascading delete, which means that the space's child resources like messages and memberships are also deleted. Use this action when you need to permanently remove a Google Chat space and all associated data. This action is irreversible — the space and all its messages and memberships cannot be recovered once deleted.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the space to delete. Format: spaces/\{space}. Example: spaces/AAQATWyCO-g
>
> **use\_admin\_access** `boolean`
>
> When true, the method runs using the calling user's Google Workspace administrator privileges. The requesting user must be a Google Workspace administrator. Requires the chat.admin.delete or chat.admin.delete.all OAuth scope.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Media
>
> **Slug:** `GOOGLE_CHAT_DOWNLOAD_MEDIA`
>
> Downloads the bytes of a Google Chat message attachment via the media API. Use this after `get_attachment` to fetch the actual file content for an attachment. The `resource_name` parameter is the `attachmentDataRef.resourceName` returned by `get_attachment`. Returns the downloaded file. The download endpoint adds `?alt=media` automatically, which is required by Google to return raw bytes rather than the JSON Media resource.
>
> #### Input Parameters
>
> **filename** `string`
>
> Optional override for the local filename of the downloaded file. If omitted, a filename is derived from the resource name.
>
> **resource\_name** `string` *required*
>
> Required. The resource name of the media to download. This is the `attachmentDataRef.resourceName` returned by `get_attachment` or by a message that includes an attachment. Example: `spaces/AAAA/messages/BBBB.BBBB/attachments/CCCC` (URL-encoded by the action).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Direct Message
>
> **Slug:** `GOOGLE_CHAT_FIND_DIRECT_MESSAGE`
>
> Returns the existing direct message space with the specified user. Use this action when you need to find an existing DM space with a particular user, such as when checking if a DM already exists before creating one or when you need the space resource name for subsequent operations. If no direct message space exists with the specified user, this action returns a NOT\_FOUND (404) error. Note: This only finds existing DM spaces - it does not create a new one. To start a new DM (or safely get-or-create one), use the GOOGLE\_CHAT\_SET\_UP\_SPACE action instead.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. The resource name of the user to find a direct message with. Format: users/\{user}. You can use 'me' as the alias for the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Group Chats
>
> **Slug:** `GOOGLE_CHAT_FIND_GROUP_CHATS`
>
> Finds group chat spaces whose human memberships contain exactly the calling user and the specified users. Results are paginated.
>
> #### Input Parameters
>
> **users** `array`
>
> Resource names of all human users in the group chat. Max 49 users. Format: users/\{user}
>
> **page\_size** `integer`
>
> Maximum number of spaces to return. Values range from 1 to 30, inclusive.
>
> **page\_token** `string`
>
> Page token for pagination. Use from a previous response's nextPageToken.
>
> **space\_view** `string`
>
> The view type to determine how much information is returned per space. One of: SPACE\_VIEW\_UNSPECIFIED, SPACE\_VIEW\_RESOURCE\_NAME\_ONLY, SPACE\_VIEW\_EXPANDED
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Attachment
>
> **Slug:** `GOOGLE_CHAT_GET_ATTACHMENT`
>
> Gets the metadata of a Google Chat message attachment. Returns the attachment's content type, filename, source, and references that can be used to download the file via the media API. To fetch the binary bytes of the attachment, pass the returned `attachmentDataRef.resourceName` to the `download_media` action. Requires Chat app authentication (the `chat.bot` scope) — this endpoint is not callable with regular user OAuth.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the attachment. Format: `spaces/{space}/messages/{message}/attachments/{attachment}`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Emoji
>
> **Slug:** `GOOGLE_CHAT_GET_CUSTOM_EMOJI`
>
> Returns details about a custom emoji in Google Chat. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. Use this action when you need to retrieve information about a specific custom emoji, such as its name, unique identifier, or temporary image URL. This is useful for displaying emoji details or verifying emoji existence before performing other operations. Note: The `payload` field is only populated when creating or updating custom emojis and is not returned when getting emoji details.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the custom emoji. Format: `customEmojis/{customEmoji}` You can use the emoji name as an alias for `{customEmoji}`. For example, `customEmojis/:example-emoji:` where `:example-emoji:` is the emoji name for a custom emoji.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chat Space Member
>
> **Slug:** `GOOGLE_CHAT_GET_MEMBER`
>
> Returns details about a membership in a space. Use this action when you need to retrieve information about a specific member's relationship with a Google Chat space, including their role, state, and user details.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}`.
>
> **use\_admin\_access** `boolean`
>
> When true, requests the membership using Google Workspace administrator privileges. Requires the calling user to be a Google Workspace administrator with the chat.admin.memberships.readonly scope.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message
>
> **Slug:** `GOOGLE_CHAT_GET_MESSAGE`
>
> Returns details about a specific message in a Google Chat space. Use this action when you need to retrieve the full content, sender information, thread details, and other metadata for a particular message. Requires user authentication with an appropriate Google Chat OAuth scope.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. The resource name of the message. Format: spaces/\{space}/messages/\{message}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Space
>
> **Slug:** `GOOGLE_CHAT_GET_SPACE`
>
> Retrieves details of a specific Google Chat space, including its display name, description, membership count, threading state, and available configuration. Administrator access can be requested when authorized; some response fields depend on the scopes used.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the space. Format: spaces/\{space}.
>
> **use\_admin\_access** `boolean`
>
> When true, returns the space using Google Workspace administrator privileges. Requires the calling user to be a Google Workspace administrator with the chat.admin.memberships.readonly scope.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Space Event
>
> **Slug:** `GOOGLE_CHAT_GET_SPACE_EVENT`
>
> Returns an event from a Google Chat space. The event payload contains the most recent version of the resource that changed. Use this action when you need to retrieve details about a specific space event, such as a new message, membership change, reaction, or space update. If the resource was modified after the event occurred, the server returns the updated resource in the event payload. Note: The `permissionSettings` field is not returned in the Space object of the Space event.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. The resource name of the space event. Format: spaces/\{space}/spaceEvents/\{spaceEvent}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Space Notification Setting
>
> **Slug:** `GOOGLE_CHAT_GET_SPACE_NOTIFICATION_SETTING`
>
> Gets the notification settings for a user in a specific space. Use when you need to retrieve the caller's space notification setting, including whether notifications are muted and what type of notifications are enabled. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.spacesettings` OAuth scope.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Required. The user for which to retrieve notification settings. Use 'me' for the authenticated user, an email address like '[user@example.com](mailto:user@example.com)', or a user ID like '123456789'.
>
> **space** `string` *required*
>
> Required. The space ID for which to retrieve notification settings. Format: spaces/\{space\_id}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get space read state
>
> **Slug:** `GOOGLE_CHAT_GET_SPACE_READ_STATE`
>
> Returns details about a user's read state within a space. Use this action when you need to identify which messages in a space have been read or unread by the user.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the space read state. Format: users/\{user}/spaces/\{space}/spaceReadState
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get thread read state
>
> **Slug:** `GOOGLE_CHAT_GET_THREAD_READ_STATE`
>
> Returns details about a user's read state within a thread. Use this action when you need to identify which messages in a specific thread have been read or unread by the user.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name of the thread read state. Format: users/\{user}/spaces/\{space}/threads/\{thread}/threadReadState
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List custom emojis
>
> **Slug:** `GOOGLE_CHAT_LIST_CUSTOM_EMOJIS`
>
> Lists custom emojis visible to the authenticated user in Google Chat. Use this action when you need to retrieve all custom emojis available in Google Chat for the authenticated user. This is useful for displaying available emojis, filtering by creator, or enumerating organization-specific custom emojis. Supports pagination via pageSize and pageToken parameters. By default, returns up to 25 emojis.
>
> #### Input Parameters
>
> **filter** `string`
>
> Query filter for custom emojis. Supports creator('users/me') or NOT creator('users/me') to filter by creator.
>
> **page\_size** `integer`
>
> Maximum number of custom emojis to return. Default is 25, maximum is 200.
>
> **page\_token** `string`
>
> Page token for pagination. Use the nextPageToken from a previous response to get the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Space Members
>
> **Slug:** `GOOGLE_CHAT_LIST_MEMBERS`
>
> Lists a page of memberships in a Google Chat space, with optional role or member-type filters and options to include Google Groups or invited members. Use the returned nextPageToken to fetch subsequent pages.
>
> #### Input Parameters
>
> **filter** `string`
>
> Optional. A query filter. You can filter memberships by a member's role (`role`) and type (`member.type`). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. You can also filter for `member.type` using the `!=` operator. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. Either `member.type = "HUMAN"` or `member.type != "BOT"` is required when `use_admin_access` is set to true. Other member type filters will be rejected.
>
> **parent** `string` *required*
>
> Resource name of the space to list memberships from. Format: spaces/\{space}
>
> **pageSize** `integer`
>
> Maximum number of memberships to return. The service may return fewer values. If unspecified, at most 25 memberships are returned. Must be between 1 and 1000.
>
> **pageToken** `string`
>
> Token for pagination. Pass the nextPageToken from a previous call to retrieve the next page of results.
>
> **showGroups** `boolean`
>
> Optional. When `true`, also returns memberships associated with a Google Group, in addition to other types of memberships. If a filter is set, Google Group memberships that don't match the filter criteria aren't returned.
>
> **showInvited** `boolean`
>
> Optional. When `true`, also returns memberships associated with invited members, in addition to other types of memberships. If a filter is set, invited memberships that don't match the filter criteria aren't returned. Currently requires user authentication.
>
> **useAdminAccess** `boolean`
>
> Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege. Requires either the `chat.admin.memberships.readonly` or `chat.admin.memberships` OAuth 2.0 scope. Listing app memberships in a space isn't supported when using admin access.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Messages
>
> **Slug:** `GOOGLE_CHAT_LIST_MESSAGES`
>
> Lists non-system messages from one Google Chat space, with creation-time or thread filtering and a next-page token. It does not search message text or filter by sender; use GOOGLE\_CHAT\_SEARCH\_MESSAGES for text search. Declared OAuth requirements include a Chat messages scope and directory.readonly.
>
> #### Input Parameters
>
> **filter** `string`
>
> Optional. A query filter. You can filter messages by date (`create_time`) and thread (`thread.name`). To filter by date, specify `create_time` with an RFC-3339 timestamp in double quotes, e.g. `"2023-04-21T11:30:00-04:00"`. Use `>` for after, `<` for before, and combine two timestamps with `AND` for a time interval. To filter by thread, specify `thread.name` formatted as `spaces/{space}/threads/{thread}` (only one `thread.name` per query). Combine thread and date with `AND`. Invalid queries are rejected by the server with INVALID\_ARGUMENT. Note: filtering by sender is NOT supported.
>
> **parent** `string` *required*
>
> Required. Full resource name of the single space to list messages from, formatted as `spaces/{space}`. Pass the complete name returned by GOOGLE\_CHAT\_LIST\_SPACES, not only the space ID.
>
> **orderBy** `string`
>
> Optional. How the list of messages is ordered. Supports create\_time asc or create\_time desc.
>
> **page\_size** `integer`
>
> Optional. Maximum number of messages to return. Defaults to 25, maximum is 1000.
>
> **page\_token** `string`
>
> Optional. Token from a previous GOOGLE\_CHAT\_LIST\_MESSAGES call to retrieve the next page. Keep parent, filter, orderBy, showDeleted, and page\_size the same as in the call that returned the token.
>
> **showDeleted** `boolean`
>
> Optional. Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List reactions on a message
>
> **Slug:** `GOOGLE_CHAT_LIST_REACTIONS`
>
> Lists a page of emoji reactions on a specific Google Chat message. Results can be filtered by emoji type or user, and a page token can be used to retrieve subsequent pages.
>
> #### Input Parameters
>
> **filter** `string`
>
> Query filter for reactions. For example, filter by emoji: 'emoji.emoji="\u00a1\u00a1"'
>
> **parent** `string` *required*
>
> Resource name of the message in format 'spaces/\{space}/messages/\{message}'
>
> **page\_size** `integer`
>
> Maximum number of reactions to return. Must be between 1 and 200. If not specified, returns all reactions.
>
> **page\_token** `string`
>
> Token for pagination. Use the nextPageToken from a previous response to get the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Section Items
>
> **Slug:** `GOOGLE_CHAT_LIST_SECTION_ITEMS`
>
> Lists all items (such as spaces) within a specified section of a user's Google Chat. Use when you need to retrieve all items grouped under a section in Google Chat, or when implementing pagination to fetch all items across multiple pages. Sections can be system sections like 'default-spaces' or custom sections created by the user. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.sections.readonly` (read-only) or `https://www.googleapis.com/auth/chat.users.sections` (full access) OAuth scope.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Required. The user who owns the section. Use 'me' for the authenticated user, or a user ID like '111477653670961777027'.
>
> **filter** `string`
>
> Optional. A query filter. Currently only supports filtering by space. For example, `space = spaces/{space}`. Invalid queries are rejected with an `INVALID_ARGUMENT` error.
>
> **section** `string` *required*
>
> Required. The section ID. Common values include 'default-spaces', 'default-apps', 'default-direct-messages', or a custom section ID.
>
> **page\_size** `integer`
>
> Maximum number of items to return. If unspecified, defaults to 25. Maximum is 100.
>
> **page\_token** `string`
>
> Token for pagination. Use the nextPageToken from a previous response to retrieve the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sections
>
> **Slug:** `GOOGLE_CHAT_LIST_SECTIONS`
>
> Lists all sections available to the authenticated user in Google Chat. Use this action when you need to retrieve all sections for organizing conversations in the navigation panel. Sections include custom sections created by the user and system sections like default direct messages, default spaces, and default apps. Requires user authentication with one of the following OAuth scopes: - [https://www.googleapis.com/auth/chat.users.sections](https://www.googleapis.com/auth/chat.users.sections) - [https://www.googleapis.com/auth/chat.users.sections.readonly](https://www.googleapis.com/auth/chat.users.sections.readonly)
>
> #### Input Parameters
>
> **parent** `string` *required*
>
> Required. The user identifier. Use 'me' for the authenticated user or provide a specific user ID.
>
> **page\_size** `integer`
>
> Optional. Maximum number of sections to return. Maximum value is 100.
>
> **page\_token** `string`
>
> Optional. Token for pagination. Use the nextPageToken value from a previous response to retrieve the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Space Events
>
> **Slug:** `GOOGLE_CHAT_LIST_SPACE_EVENTS`
>
> Lists events from a Google Chat space. Use when you need to retrieve historical events such as new messages, membership changes, or reactions from a specific Google Chat space. The filter parameter is required and must specify event type filters. Note: This action requires specifying event type filters in the filter parameter. Supported event types include message events (created, updated, deleted), membership events (created, updated, deleted), and reaction events.
>
> #### Input Parameters
>
> **filter** `string` *required*
>
> Required filter for space events. Use format: event\_types:"EVENT\_TYPE". For multiple types, separate with OR. Examples: 'event\_types:"google.workspace.chat.message.v1.created"', 'event\_types:"google.workspace.chat.membership.v1.created" OR event\_types:"google.workspace.chat.membership.v1.deleted"'
>
> **parent** `string` *required*
>
> Resource name of the space to list events from. Format: spaces/\{space}. You can get this value from the spaces.list response or from the space URL.
>
> **page\_size** `integer`
>
> Maximum number of space events to return. Accepts values between 1 and 500. If not specified, defaults to 25.
>
> **page\_token** `string`
>
> Token for pagination. Use the nextPageToken from a previous response to retrieve the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Spaces
>
> **Slug:** `GOOGLE_CHAT_LIST_SPACES`
>
> Lists a page of Google Chat spaces the authenticated user belongs to, using the chat.spaces or chat.spaces.readonly OAuth scope. Group chats and direct messages are not listed until the first message is sent.
>
> #### Input Parameters
>
> **filter** `string`
>
> Optional. Query filter for space type. Format: spaceType = "VALUE" where VALUE can be SPACE, GROUP\_CHAT, or DIRECT\_MESSAGE. Use OR to separate multiple types. Cannot be SPACE\_TYPE\_UNSPECIFIED.
>
> **page\_size** `integer`
>
> Optional. Maximum number of spaces to return. Defaults to 100, maximum is 1000. Values over 1000 are auto-adjusted to 1000.
>
> **page\_token** `string`
>
> Optional. Token from previous list spaces call to retrieve the next page. Must match the original call's filter value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Section Item
>
> **Slug:** `GOOGLE_CHAT_MOVE_SECTION_ITEM`
>
> Moves a space from one section to another in Google Chat. Use when organizing spaces into different sections, such as moving a space from the default-spaces section to a custom user-created section. The action updates the section membership of the specified space item.
>
> #### Input Parameters
>
> **item** `string` *required*
>
> The item ID. Format: items/\{item}
>
> **user** `string` *required*
>
> The user ID. Format: users/\{user}
>
> **section** `string` *required*
>
> The section ID. Format: sections/\{section}
>
> **target\_section** `string` *required*
>
> The target section to move the item to. Must be the full resource name in the format `users/{user}/sections/{section}` — a bare section ID is rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Position Section in Sidebar
>
> **Slug:** `GOOGLE_CHAT_POSITION_SECTION`
>
> Changes the sort order of a section in the Google Chat sidebar. Use when you need to reorder sections in the sidebar. Either sortOrder (absolute position) or relativePosition (START/END) must be provided to specify the new position.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> The user ID or resource name. Format: users/\{user}
>
> **section** `string` *required*
>
> The section ID or resource name. Format: sections/\{section}
>
> **sort\_order** `integer`
>
> The absolute position of the section in the list. Must be greater than 0. If greater than the number of sections, the section appends to the end.
>
> **relative\_position** `string ("START" | "END")`
>
> Relative position options for section positioning.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Replace Message (Full)
>
> **Slug:** `GOOGLE_CHAT_REPLACE_MESSAGE`
>
> Updates a Google Chat message using a field mask, with support for text, cards, attachments, and other supplied properties. It can request creation of a missing message using a client-assigned ID.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the message to replace. Format: spaces/\{space}/messages/\{message}. Supports custom client-assigned IDs.
>
> **text** `string`
>
> Plain-text message body. Supports link previews and @mentions. Newlines can be represented with \n.
>
> **cardsV2** `array`
>
> List of interactive cards (max 32KB total). Each card contains sections with widgets. Use this for rich interactive messages instead of deprecated 'cards'.
>
> **attachment** `array`
>
> User-uploaded files to attach. Replaces all existing attachments.
>
> **updateMask** `string` *required*
>
> Required. Comma-separated list of field paths to update. Use '\*' for full replacement. Supported fields: text, attachment, cards, cardsV2, accessoryWidgets, quotedMessageMetadata.
>
> **allowMissing** `boolean`
>
> If true and the message specified by 'name' does not exist, creates a new message using the specified messageId (requires clientAssignedMessageId). Defaults to false.
>
> **fallbackText** `string`
>
> Plain-text description of cards for fallback in notifications and when cards cannot be displayed.
>
> **quotedMessageMetadata** `object`
>
> Metadata for quoting a message. Includes name, lastUpdateTime, quoteType, and optionally forwardedMetadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Messages
>
> **Slug:** `GOOGLE_CHAT_SEARCH_MESSAGES`
>
> Searches for messages across Google Chat spaces the caller has access to. Use this action to find messages by keyword, sender, space, attachment presence, or mentions, instead of paging through ListMessages for a single space. Excludes private messages, Chat app messages, messages from blocked users, and messages in muted spaces. Requires user authentication with one of the following core OAuth scopes: - [https://www.googleapis.com/auth/chat.messages](https://www.googleapis.com/auth/chat.messages) - [https://www.googleapis.com/auth/chat.messages.readonly](https://www.googleapis.com/auth/chat.messages.readonly) Some filters and FULL-view metadata require the additional scopes documented on their request fields. Display-name enrichment is best-effort and optional.
>
> #### Input Parameters
>
> **view** `string ("SEARCH_MESSAGES_VIEW_BASIC" | "SEARCH_MESSAGES_VIEW_FULL")`
>
> How much detail to include for each search result.
>
> **filter** `string` *required*
>
> Required. A search query supporting free-text keywords and field filters. Filterable fields: `create_time` (only `<`/`>=`, e.g. `create_time >= "2024-01-01T00:00:00Z"`), `sender.name` (`=` only, resource name of a user, e.g. `users/123456789`), `space.name` (`=` only), `space.display_name` (partial match with `:`, e.g. `space.display_name:"Eng Showcase"`; requires `chat.spaces` or `chat.spaces.readonly`), `attachment` (presence check with `attachment:*`), and `annotations.user_mentions.user.name` (`:` match). Advanced functions `is_unread()` (requires `chat.users.readstate` or `chat.users.readstate.readonly`) and `has_link()` are also supported. Combine different fields with `AND`.
>
> **parent** `string`
>
> Required fixed search root. Google only accepts `spaces/-`; restrict searches to specific spaces with `space.name` or `space.display_name` in filter.
>
> **orderBy** `string ("create_time desc" | "relevance desc")`
>
> Supported result ordering for message searches.
>
> **pageSize** `integer`
>
> Optional. Maximum number of results to return. Defaults to 25, maximum is 100.
>
> **pageToken** `string`
>
> Optional. Token from a previous SearchMessages call to retrieve the next page.
>
> **markupSyntax** `string ("MARKUP_SYNTAX_CHAT" | "MARKUP_SYNTAX_MARKDOWN")`
>
> Syntax used for the returned message formattedText field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Spaces
>
> **Slug:** `GOOGLE_CHAT_SEARCH_SPACES`
>
> Searches Google Chat spaces using filters such as display name, customer, creation time, activity, history state, and space type. Searches can use administrator access across a Workspace organization or user access to spaces the caller belongs to.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Required. A search query. Filterable fields: `create_time`, `customer`, `display_name`, `external_user_allowed`, `last_active_time`, `space_history_state`, `space_type`. Examples: `customer = "customers/my_customer" AND space_type = "SPACE"`, `display_name:"Project*"`, `create_time > "2024-01-01T00:00:00Z"`.
>
> **orderBy** `string`
>
> How the list of spaces is ordered. Supported attributes: `membership_count.joined_direct_human_user_count`, `last_active_time`, `create_time`. Valid ordering operation values: `ASC` (ascending, default) and `DESC` (descending). Example: `membership_count.joined_direct_human_user_count DESC`.
>
> **pageSize** `integer`
>
> The maximum number of spaces to return. Service may return fewer than this value. Default and maximum are 100.
>
> **pageToken** `string`
>
> A page token from a previous SearchSpaces call. Provide to retrieve the next page.
>
> **useAdminAccess** `boolean`
>
> Required by the API to be `true`. Runs the search using Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with one of the admin scopes (chat.admin.spaces or chat.admin.spaces.readonly).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Setup Space
>
> **Slug:** `GOOGLE_CHAT_SET_UP_SPACE`
>
> Creates a Google Chat named space, group chat, human DM, or calling-app DM and can add initial members. The caller is added automatically. Named spaces require displayName. Group chats require at least two memberships. Human DMs require exactly one HUMAN membership. For a calling-app DM, set singleUserBotDm to true and omit memberships. An existing human DM is returned. Google groups can only join named spaces. This is the only action that creates DIRECT\_MESSAGE or GROUP\_CHAT spaces; CREATE\_SPACE, CREATE\_MESSAGE, and CREATE\_MEMBER require an existing space. Requires user authentication with one of the following OAuth scopes: - [https://www.googleapis.com/auth/chat.spaces](https://www.googleapis.com/auth/chat.spaces) - [https://www.googleapis.com/auth/chat.spaces.create](https://www.googleapis.com/auth/chat.spaces.create)
>
> #### Input Parameters
>
> **requestId** `string`
>
> A unique identifier for this request. A random UUID is recommended. Specifying an existing request ID returns the space created with that ID instead of creating a new space.
>
> **spaceType** `string ("SPACE" | "GROUP_CHAT" | "DIRECT_MESSAGE")` *required*
>
> Required. The type of space to create: SPACE for named spaces, GROUP\_CHAT for group chats, or DIRECT\_MESSAGE for 1:1 conversations.
>
> **displayName** `string`
>
> The display name of the space. Required when spaceType is SPACE.
>
> **memberships** `array`
>
> The Google Chat users or groups to invite. Up to 49 memberships are allowed. GROUP\_CHAT requires at least two memberships, and a human DIRECT\_MESSAGE requires exactly one HUMAN membership. Omit memberships when singleUserBotDm is true.
>
> **singleUserBotDm** `boolean`
>
> Set to true to create a DM between the calling user and the calling Chat app. Only valid with spaceType DIRECT\_MESSAGE, and memberships must be omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Member
>
> **Slug:** `GOOGLE_CHAT_UPDATE_MEMBER`
>
> Updates a user's membership role in a Google Chat space, such as changing between member and manager.
>
> #### Input Parameters
>
> **role** `string ("MEMBERSHIP_ROLE_UNSPECIFIED" | "ROLE_MEMBER" | "ROLE_MANAGER" | "ROLE_ASSISTANT_MANAGER")` *required*
>
> Required. The new role for the member. Use ROLE\_MEMBER for regular members, ROLE\_MANAGER to make them a manager, or ROLE\_ASSISTANT\_MANAGER for assistant manager.
>
> **space\_id** `string` *required*
>
> Required. Resource name of the space where the membership exists. Format: `spaces/{space}`
>
> **member\_id** `string` *required*
>
> Required. Resource name of the member to update. Format: `spaces/{space}/members/{member}`
>
> **update\_mask** `string` *required*
>
> Required. The field paths to update, comma-separated if multiple. Currently the only supported field is 'role'.
>
> **use\_admin\_access** `boolean`
>
> Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Message
>
> **Slug:** `GOOGLE_CHAT_UPDATE_MESSAGE`
>
> Updates a Google Chat message's text, cards, or other supported properties using an update mask. With allowMissing enabled, it can create a message when the specified message is missing; permitted updates depend on authentication and permissions.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required. Resource name of the message. Format: spaces/\{space}/messages/\{message}. Supports custom client-assigned IDs.
>
> **text** `string`
>
> Plain-text message body. Supports link previews and @mentions. Newlines can be represented with \n.
>
> **cardsV2** `array`
>
> List of interactive cards (max 32KB total). Each card contains sections with widgets. Use this for rich interactive messages instead of deprecated 'cards'.
>
> **attachment** `array`
>
> User-uploaded files to attach. Attachments are appended to existing attachments.
>
> **updateMask** `string` *required*
>
> Required. Comma-separated list of field paths to update. Use '\*' for full replacement. Supported fields: text, attachment, cards, cardsV2, accessoryWidgets, quotedMessageMetadata.
>
> **allowMissing** `boolean`
>
> If true and the message specified by 'name' does not exist, creates a new message using the specified messageId (requires clientAssignedMessageId). Defaults to false.
>
> **fallbackText** `string`
>
> Plain-text description of cards for fallback in notifications and when cards cannot be displayed.
>
> **quotedMessageMetadata** `object`
>
> Metadata for quoting a message. Includes name, lastUpdateTime, quoteType, and optionally forwardedMetadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update section
>
> **Slug:** `GOOGLE_CHAT_UPDATE_SECTION`
>
> Updates a section's display name in Google Chat. This action uses patch semantics for partial updates. Use when you need to rename an existing custom section in Google Chat. Only sections of type 'CUSTOM\_SECTION' can be updated. System sections (like 'default-direct-messages', 'default-spaces', 'default-apps') cannot have their display names modified. Requires user authentication with the '[https://www.googleapis.com/auth/chat.users.sections](https://www.googleapis.com/auth/chat.users.sections)' scope.
>
> #### Input Parameters
>
> **user** `string`
>
> The user whose sections to update. Use 'me' to refer to the authenticated user. Format: 'users/\{user}' or 'me' for the authenticated user.
>
> **section** `string` *required*
>
> The section ID to update. Format: 'users/\{user}/sections/\{section}'. For example: 'MTc3NTc5OTg0MTk4MzIwMTAxNA'.
>
> **update\_mask** `string` *required*
>
> Required. The field paths to update, comma-separated if multiple. Currently supported: 'displayName'.
>
> **display\_name** `string`
>
> The new display name for the section. Only sections of type 'CUSTOM\_SECTION' can be updated. Supports up to 80 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Space
>
> **Slug:** `GOOGLE_CHAT_UPDATE_SPACE`
>
> Updates an existing Google Chat space's display name, description, guidelines, history state, or predefined permission settings using an update mask. It can request administrator access when authorized.
>
> #### Input Parameters
>
> **guidelines** `string`
>
> Guidelines for the space. Max 5000 characters.
>
> **space\_name** `string` *required*
>
> Required. Resource name of the space. Format: spaces/\{space}
>
> **description** `string`
>
> Description of the space. Max 150 characters.
>
> **update\_mask** `string` *required*
>
> Required. The field paths to update, comma-separated if multiple. Common values: displayName, spaceDetails (covers both description and guidelines), spaceHistoryState, predefinedPermissionSettings, permissionSettings. Note: to update `description` or `guidelines`, use `spaceDetails` in the update mask (both fields live under the `spaceDetails` object).
>
> **display\_name** `string`
>
> New display name for the space. Max 128 characters.
>
> **use\_admin\_access** `boolean`
>
> When true, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the chat.admin.spaces scope.
>
> **space\_history\_state** `string ("HISTORY_OFF" | "HISTORY_ON")`
>
> Defines the space history state for messages.
>
> **predefined\_permission\_settings** `string ("COLLABORATION_SPACE" | "ANNOUNCEMENT_SPACE")`
>
> Predefined permission settings for a space.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Space Notification Setting
>
> **Slug:** `GOOGLE_CHAT_UPDATE_SPACE_NOTIFICATION_SETTING`
>
> Updates the notification settings for a user in a space. Use when you need to modify how a user receives notifications in a specific space, such as muting a noisy channel or changing the notification level to only important messages. Requires user authentication with the chat.users.spacesettings scope.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Identifier for the user. Use 'me' to refer to the authenticated user.
>
> **space** `string` *required*
>
> Identifier of the space. Format: spaces/SPACE\_ID.
>
> **updateMask** `string` *required*
>
> Required. Comma-separated list of field paths to update. Supported: notification\_setting, mute\_setting.
>
> **muteSetting** `string ("MUTE_SETTING_UNSPECIFIED" | "UNMUTED" | "MUTED")`
>
> Mute setting options for space notifications.
>
> **notificationSetting** `string ("NOTIFICATION_SETTING_UNSPECIFIED" | "ALL" | "MAIN_CONVERSATIONS" | "FOR_YOU" | "OFF")`
>
> Notification setting options for space notifications.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Space Read State
>
> **Slug:** `GOOGLE_CHAT_UPDATE_SPACE_READ_STATE`
>
> Updates a user's read state within a space, used to mark messages as read or unread. Use this action when you need to programmatically mark a Google Chat space as read or update the user's read position in a space. Note: To mark a space as unread, set lastReadTime to a value earlier than the latest message timestamp. To mark as read, set it to any value later than the latest message.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Identifier for the user. Use 'me' to refer to the authenticated user.
>
> **space** `string` *required*
>
> Identifier of the space. Format: spaces/SPACE\_ID.
>
> **updateMask** `string` *required*
>
> Required. Comma-separated list of field paths to update. Supported: lastReadTime.
>
> **lastReadTime** `string`
>
> The timestamp when the user's read state was last updated. When set to a time later than the latest message, the space appears as read. Format: RFC 3339 format (e.g., '2026-04-09T17:00:00.000Z').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Media Attachment
>
> **Slug:** `GOOGLE_CHAT_UPLOAD_MEDIA`
>
> Uploads a file of up to 200 MB as an attachment to a Google Chat space using the multipart media upload endpoint; the returned attachment upload token can be used in a subsequent message. Requires user authentication and either the chat.messages or chat.messages.create scope.
>
> #### Input Parameters
>
> **parent** `string` *required*
>
> Required. Resource name of the Chat space in which the attachment is uploaded. Format: `spaces/{space}`.
>
> **filename** `string`
>
> Optional override for the filename sent in the upload metadata. If omitted, the FileUploadable's name is used.
>
> **file\_to\_upload** `object` *required*
>
> The file to upload. Maximum size 200 MB. Any MIME type accepted by the Google Chat media endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
