Google Chat

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-wi…

Untrusted display-only summary

Creates a custom emoji in Google Chat for use within an organization. Use this action when you need to add a custom emoji that can be used by members of your Google Workspace organization. The emoji will be available in Google Chat after creation. Note: Custom emojis are only available for Google Workspace accounts an…

Untrusted display-only summary

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 use…

Untrusted display-only summary

Creates a message in a Google Chat space. With user authentication, only text messages are supported. Maximum message size is 32,000 bytes. Use this action when you need to send a message to a Google Chat space or channel. You can reply to existing threads by providing a thread_key, or start a new conversation. Messag…

Untrusted display-only summary

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…

Untrusted display-only summary

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.

Untrusted display-only summary

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 conversation…

Untrusted display-only summary

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 —…

Untrusted display-only summary

Removes a user, Google Group, or app from a space. This action is irreversible — once removed, the member cannot be recovered and will need to be re-added to the space. Use when you need to remove a specific member from a Google Chat space. Note: Deleted members will lose access to the space immediately and will need…

Untrusted display-only summary

Deletes a message from a Google Chat space. Use this action when you need to remove a message that is no longer needed, was posted in error, or is outdated. App authentication can only delete messages created by the calling Chat app. User authentication with proper permissions can delete any message in a space they ma…

Untrusted display-only summary

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.

Untrusted display-only summary

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 need…

Untrusted display-only summary

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 m…

Untrusted display-only summary

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 `?al…

Untrusted display-only summary

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 wi…

Untrusted display-only summary

Finds all group chat spaces that contain exactly the calling user and the specified users. This action uses the Google Chat Developer Preview API to search for GROUP_CHAT spaces whose human memberships contain exactly the calling user and the specified users. Use this action when you need to find existing group chats…

Untrusted display-only summary

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. Require…

Untrusted display-only summary

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 tempor…

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

Returns details about a specific Google Chat space including configuration, membership count, and access settings. Use this action when you need to retrieve information about a specific space in Google Chat, such as getting the space's display name, description, membership count, threading state, or access settings. N…

Untrusted display-only summary

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 o…

Untrusted display-only summary

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` OA…

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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 pagin…

Untrusted display-only summary

Lists memberships in a space. Returns a list of all members including users, bots, and Google Groups. Use when you need to retrieve all members of a Google Chat space, such as to get a list of participants, check who has access, or find specific members by role or type. Supports pagination when there are many members…

Untrusted display-only summary

Lists messages in a space that the authenticated user is a member of. Use this action when you need to retrieve messages from a Google Chat space, such as displaying message history, searching for specific messages, or monitoring space activity. Supports filtering and ordering of messages. Pagination is available via…

Untrusted display-only summary

Lists all reactions on a specific message in a Google Chat space. Use when you need to retrieve all emoji reactions (likes, thumbs up, hearts, etc.) that users have added to a message. This action is read-only and does not modify any data. The results can be filtered by emoji type or user using the filter parameter.

Untrusted display-only summary

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…

Untrusted display-only summary