Delete a message - Zoom API

Delete a chat message that you previously sent to a contact or a channel. In the query parameter, you must provide either of the following:

to_contact: The email address of the contact to whom you sent the message. Use this parameter to delete a message sent to an individual contact in Zoom.

to_channel: The channel ID of the channel where you sent the message. Use this parameter to delete a message sent to a channel in Zoom.

Note: For an account-level OAuth app, this API can only be used on behalf of a user who is assigned with a role that has Edit permission for Chat Messages.

Scope: chat_message:write, chat_message:write:admin

Rate Limit Label: Medium

请求参数

Path 参数

messageId

string

必需

Message ID

userId

string

必需

Query 参数

to_contact

string

可选

The userId or email address of a chat contact to whom you previously sent the message.

Note: You must provide either to_contact or to_channel as a query parameter to delete a message that was previously sent to either an individual or a chat channel respectively.

to_channel

string

可选

The channel Id of the channel where you would like to send the message.

You must provide either to_contact or to_channel as a query parameter to delete a message that was previously sent to either an individual or a chat channel

返回响应

🟢204**HTTP Status Code:** `204` Message deleted.

application/json

Body

object {0}

🟠400**HTTP Status Code:** `400` Bad request. **Error Code:** `200` The contact or the channel parameter provided is invalid. Only the sender of this message can make updates. **Error Code:** `300` Channel does not exist: $messageId M

🟠404**HTTP Status Code:** `404` **Error Code**: `1001` User does not exist: $to_contact. **Error Code**: `4130` Channel does not exist: $to_channel.