Method: spaces.delete | Google Chat | Google for Developers (original) (raw)
- 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.deletehttps://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 | 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.
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/chat.app.deletehttps://www.googleapis.com/auth/chat.admin.deletehttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.delete
For more information, see the Authorization guide.