Skip to main content

Overview

A group administrator deletes a message sent by another group member. After deletion, no group member can view it.

Request

Authentication: Add authentication headers to the request. See Authentication

Method: POST

Rate limit: 100 requests/second

Endpoint: https://API domain/jim/messages/del

Content-Type: application/json

Request parameters

ParameterData typeRequiredDescription
from_idstringYesSender ID of the message to delete.
target_idstringYesMessage recipient; for a group, this is the group ID.
channel_typeintYesConversation type: 1 for private chat; 2 for group chat.
msgs.msg_idstringYesID of the message to delete.
msgs.msg_timeintYesSend time of the message to delete.

Request example

POST /jim/messages/recall HTTP/1.1
appkey: appkey
Authorization: xxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
"from_id":"userid1",
"target_id":"group1",
"channel_type":2,
"msgs":[
{
"msg_id":"xxxx",
"msg_time":1731234567823
}
]
}

Response example

{
"code":0,
"msg":"sucess"
}

Response codes

Response codesDescription