Method: spaces.delete
Stay organized with collections
Save and categorize content based on your preferences.
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:
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.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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-25 UTC.
[null,null,["Last updated 2025-07-25 UTC."],[[["\u003cp\u003eThis request permanently deletes a space and all its child resources, including messages and memberships.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication can be performed using app authentication (with administrator approval) or user authentication (including with administrator privileges using \u003ccode\u003euseAdminAccess\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the space's resource name in the URL path and can optionally use the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter for administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, such as \u003ccode\u003echat.app.delete\u003c/code\u003e or \u003ccode\u003echat.admin.delete\u003c/code\u003e, as detailed in the Authorization guide.\u003c/p\u003e\n"]]],["This describes how to delete a named space using the Chat API, including its child resources. A `DELETE` request is sent to `https://chat.googleapis.com/v1/{name=spaces/*}`. The `name` path parameter specifies the space to delete. The `useAdminAccess` query parameter enables administrator privileges, which requires the `chat.admin.delete` OAuth scope and specific admin rights. The request body must be empty, and a successful deletion returns an empty JSON object. Authorization requires specific OAuth scopes.\n"],null,["# Method: spaces.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes 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](https://developers.google.com/workspace/chat/delete-spaces).\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and the authorization scope:\n\n - `https://www.googleapis.com/auth/chat.app.delete` (only in spaces the app created)\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.delete`\n - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)\n - User authentication grants administrator privileges when an administrator account authenticates, `useAdminAccess` is `true`, and the following authorization scope is used:\n - `https://www.googleapis.com/auth/chat.admin.delete`\n\n### HTTP request\n\n`DELETE https://chat.googleapis.com/v1/{name=spaces/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the space to delete. Format: `spaces/{space}` |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.app.delete`\n- `https://www.googleapis.com/auth/chat.admin.delete`\n- `https://www.googleapis.com/auth/chat.import`\n- `https://www.googleapis.com/auth/chat.delete`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
