Remove a member from a space

This guide explains how to use the delete method on the membership resource of the Google Chat API to remove member from a space also known as deleting a membership. Space managers can't be removed if they're the only space manager in a space. Assign another user as a space manager before removing these memberships.

The Membership resource represents whether a human user or Google Chat app is invited to, part of, or absent from a space.



  • Python 3.6 or greater
  • The pip package management tool
  • The latest Google client libraries for Python. To install or update them, run the following command in your command-line interface:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • A Google Cloud project with the Google Chat API enabled and configured. For steps, see Build a Google Chat app.
  • Authorization configured for the Chat app. Deleting a membership requires User authentication with the chat.memberships or authorization scope from a user who has permission to delete the specified membership.

Remove a member from a space

To remove a user, Google Group, or Chat app from a space:

  • To remove a user or Google Group, specify the chat.memberships authorization scope. To remove a Chat app, specify the authorization scope (apps can only delete their own membership; not that of other apps). As a best practice, choose the most restrictive scope that still allows your app to function.
  • Call the delete method on the membership resource.
  • Pass the name of the membership to delete. If the membership belongs to the only space manager in a space, assign another user as a space manager before deleting this membership.

Here's how to delete a membership:


  1. In your working directory, create a file named
  2. Include the following code in

    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    # Define your app's authorization scopes.
    # When modifying these scopes, delete the file token.json, if it exists.
    SCOPES = [""]
    def main():
        Authenticates with Chat API via user credentials,
        then deletes the specified membership.
        # Authenticate with Google Workspace
        # and get user authorization.
        flow = InstalledAppFlow.from_client_secrets_file(
                    'client_secrets.json', SCOPES)
        creds = flow.run_local_server()
        # Build a service endpoint for Chat API.
        chat = build('chat', 'v1', credentials=creds)
        # Use the service endpoint to call Chat API.
        result = chat.spaces().members().delete(
            # The membership to delete.
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            # Replace MEMBER with a membership name.
            # Obtain the membership name from the memberships resource of
            # Chat API. To delete a Chat app's membership, replace MEMBER
            # with app; an alias for the app calling the API.
        # Print Chat API's response in your command line interface.
        # When deleting a membership, the response body is empty.
    if __name__ == '__main__':
  3. In the code, replace the following:

    • SPACE: a space name, which you can obtain from the spaces.list method in the Chat API, or from a space's URL.

    • MEMBER: a membership name, which you can obtain from the spaces.members.list method in the Chat API. To delete an app's membership, replace MEMBER with app.

  4. In your working directory, build and run the sample:


If successful, the response body returns the membership with 'state': 'NOT_A_MEMBER', indicating that the member is no longer in the space.

    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"