Method: subscriptions.delete
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
DELETE https://workspaceevents.googleapis.com/v1/{name=subscriptions/*}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
Required. Resource name of the subscription to delete. Format: subscriptions/{subscription}
|
Query parameters
| Parameters |
validateOnly |
boolean
Optional. If set to true, validates and previews the request, but doesn't delete the subscription.
|
allowMissing |
boolean
Optional. If set to true and the subscription isn't found, the request succeeds but doesn't delete the subscription.
|
etag |
string
Optional. Etag of the subscription. If present, it must match with the server's etag. Otherwise, request fails with the status ABORTED.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Operation.
- The
metadata field contains an empty array. - The
response field is empty.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
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-10 UTC.
[null,null,["Last updated 2025-07-10 UTC."],[[["\u003cp\u003eThis method deletes a Google Workspace subscription using a \u003ccode\u003eDELETE\u003c/code\u003e request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003ename\u003c/code\u003e path parameter specifying the subscription to delete and optional query parameters for validation, error handling, and etag verification.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and a successful response returns an \u003ccode\u003eOperation\u003c/code\u003e object indicating the deletion status.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires one of the listed OAuth scopes, providing access to various Google Chat and Meet functionalities.\u003c/p\u003e\n"]]],["To delete a Google Workspace subscription, send a `DELETE` request to `https://workspaceevents.googleapis.com/v1/{name=subscriptions/*}`, specifying the subscription's resource name in the `name` path parameter. The request body must be empty. Optional query parameters include `validateOnly`, `allowMissing`, and `etag` for validation, handling missing subscriptions, and matching server etags. Successful responses return an `Operation` instance with empty `metadata` and `response` fields. Requires specific OAuth scopes for authorization.\n"],null,["# Method: subscriptions.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\nDeletes a Google Workspace subscription. To learn how to use this method, see [Delete a Google Workspace subscription](https://developers.google.com/workspace/events/guides/delete-subscription).\n\n### HTTP request\n\n`DELETE https://workspaceevents.googleapis.com/v1/{name=subscriptions/*}`\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 subscription to delete. Format: `subscriptions/{subscription}` |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `validateOnly` | `boolean` Optional. If set to `true`, validates and previews the request, but doesn't delete the subscription. |\n| `allowMissing` | `boolean` Optional. If set to `true` and the subscription isn't found, the request succeeds but doesn't delete the subscription. |\n| `etag` | `string` Optional. Etag of the subscription. If present, it must match with the server's etag. Otherwise, request fails with the status `ABORTED`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/workspace/events/reference/rest/v1/operations#Operation).\n\n- The `metadata` field contains an empty array.\n- The `response` field is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.bot`\n- `\n https://www.googleapis.com/auth/chat.spaces`\n- `\n https://www.googleapis.com/auth/chat.spaces.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages`\n- `\n https://www.googleapis.com/auth/chat.messages.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions.readonly`\n- `\n https://www.googleapis.com/auth/chat.memberships`\n- `\n https://www.googleapis.com/auth/chat.memberships.readonly`\n- `\n https://www.googleapis.com/auth/meetings.space.created`\n- `\n https://www.googleapis.com/auth/meetings.space.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
