Method: spaces.delete

  • This request permanently deletes a space and all its child resources, including messages and memberships.

  • Authentication can be performed using app authentication (with administrator approval) or user authentication (including with administrator privileges using useAdminAccess).

  • The request requires the space's resource name in the URL path and can optionally use the useAdminAccess query parameter for administrator privileges.

  • Requires specific OAuth scopes for authorization, such as chat.app.delete or chat.admin.delete, as detailed in the Authorization guide.

Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. For an example, see Delete a space.

Supports the following types of authentication:

  • App authentication with administrator approval and the authorization scope:

    • https://www.googleapis.com/auth/chat.app.delete (only in spaces the app created)

  • User authentication with one of the following authorization scopes:

    • https://www.googleapis.com/auth/chat.delete
    • https://www.googleapis.com/auth/chat.import (import mode spaces only)
    • User authentication grants administrator privileges when an administrator account authenticates, useAdminAccess is true, and the following authorization scope is used:
      • https://www.googleapis.com/auth/chat.admin.delete

HTTP request

DELETE https://chat.googleapis.com/v1/{name=spaces/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Resource name of the space to delete.

Format: spaces/{space}

Query parameters

Parameters
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 the chat.admin.delete OAuth 2.0 scope.

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

For more information, see the Authorization guide.