删除仅特定人可见的消息卡片

POST

/ephemeral/v1/delete

在群会话中删除指定用户可见的临时消息卡片
临时卡片消息可以通过该接口进行显式删除，临时卡片消息删除后将不会在该设备上留下任何痕迹。
权限说明：需要启用机器人能力；需要机器人在会话群里

错误码

错误码	说明	排查建议
18051	临时消息已删除	该临时消息已被用户删除，无法删除

其他通用错误码可参考：服务端错误码说明

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/ephemeral/v1/delete' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
   "message_id": "om_5ad573a6411d72b8305fda3a9c15c70e"
}'

响应示例

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

修改于 2025-10-20 10:15:59

发送仅特定人可见的消息卡片

资源介绍

删除仅特定人可见的消息卡片

错误码#

请求参数

返回响应

错误码