AI-generated Key Takeaways
-
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
useAdminAccessquery parameter for administrator privileges. -
Requires specific OAuth scopes for authorization, such as
chat.app.deleteorchat.admin.delete, as detailed in the Authorization guide.
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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,
useAdminAccessistrue, 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
|
Required. Resource name of the space to delete. Format: |
Query parameters
| Parameters | |
|---|---|
useAdminAccess
|
Optional. When The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege . Requires the |
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 .
