Method: spaces.messages.delete

Stay organized with collections Save and categorize content based on your preferences.

Deletes a message. For example usage, see Delete a message.

Requires authentication. Fully supports service account authentication.

Supports user authentication as part of the Google Workspace Developer Preview Program, which grants early access to certain features. User authentication requires the chat.messages authorization scope.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Resource name of the message to be deleted, in the form "spaces/*/messages/*"

Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

Query parameters

Parameters
force

boolean

When true, deleting a message also deletes its threaded replies. When false, if a message has threaded replies, deletion fails.

Only applies when authenticating as a user. Has no effect when authenticating with a service account.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages

For more information, see the Authorization guide.