Deletes (recalls) a specific one-to-one chat message.
Operation description
The single-user QPS limit for this operation is 50 calls per second. Exceeding this limit will trigger throttling, which may affect your business. Call this operation appropriately.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
live:DeleteLiveMessageUserMessage |
delete |
*Domain
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AppId |
string |
Yes |
The application ID. |
demo |
| ReceiverId |
string |
Yes |
The ID of the user who receives the delete message notification. The value consists of uppercase and lowercase letters and digits, and cannot exceed 64 bytes in length. |
169830**** |
| MessageId |
string |
Yes |
The ID of the message to be deleted, which corresponds to the MsgTid in the send message operation. The value consists of uppercase and lowercase letters and digits, and cannot exceed 64 bytes in length. |
********** |
| DeleterId |
string |
No |
The ID of the user who initiates the message deletion. The value consists of uppercase and lowercase letters and digits, and cannot exceed 64 bytes in length. This parameter is required in practice. If not specified, InputInvalid is returned. |
169830**** |
| DeleterInfo |
string |
No |
The extended information of the user who initiates the message deletion. The value cannot exceed 512 bytes in length. |
username |
| DataCenter |
string |
No |
The data center, which must be the same as the data center specified in CreateLiveMessageApp. Currently, Shanghai (cn-shanghai) and Singapore (ap-southeast-1) are supported. |
cn-shanghai |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| RequestId |
string |
The request ID. |
6CFDE7AB-571A-14EA-B072-989FF753**** |
Examples
Success response
JSON format
{
"RequestId": "6CFDE7AB-571A-14EA-B072-989FF753****"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InputInvalid | %s. | Illegal input parameters |
| 500 | ServerError | %s. | Unknown error, please try again later or submit a ticket for consultation. |
| 403 | NoAuth | %s. | No permission |
| 404 | ResourceNotExist | %s. | The requested resource does not exist, please check and try again |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.