助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
工作流
应用
资源
发布
模型
多人协作
开发工具
Coze CLI
API 参考
SDK 参考
音视频
推广与变现

删除消息评价

更新于: 2026-06-25 19:29:14

删除指定消息的评价。

接口限制

仅会话创建者能删除对应会话中消息的评价。

基础信息

请求方式

DELETE

请求地址

https://api.coze.cn/v1/conversations/:conversation_id/messages/:message_id/feedback

权限

feedback
确保调用该接口使用的访问令牌开通了 feedback 权限,详细信息参考鉴权方式

接口说明

删除指定消息的评价。

请求参数

参数

取值

说明

Authorization

Bearer $Access_Token

用于验证客户端身份的访问令牌。你可以在扣子编程中生成访问令牌,详细信息,参考准备工作

Content-Type

application/json

解释请求正文的方式。

Path

参数

类型

是否必选

示例

说明

conversation_id

String

必选

737363834493434****

Conversation ID,即会话的唯一标识。可以在发起对话接口 Response 中查看 conversation_id 字段。

message_id

String

必选

74076856761178****

待删除评价的消息 ID。你可以通过查看对话消息详情 API 返回的 Response 中查看消息 ID。

  • 此消息必须在 conversation_id 指定的会话中。
  • 仅支持评价以下来源的文本消息:
    • 通过发起对话 API 生成的 type=answer 类型的文本消息。
    • 通过执行对话流 API 返回的文本消息。

返回参数

参数

类型

示例

说明

detail

Object of ResponseDetail

{“logid”:“20241210152726467C48D89D6DB2****”}

包含请求的详细日志信息,用于问题排查和技术支持。

code

Long

0

调用状态码。0 表示调用成功,其他值表示调用失败,你可以通过 msg 字段判断详细的错误原因。

msg

String

“”

状态信息。API 调用失败时可通过此字段查看详细错误信息。
状态码为 0 时,msg 默认为空。

ResponseDetail

参数

类型

示例

说明

logid

String

20241210152726467C48D89D6DB2****

本次请求的日志 ID。如果遇到异常报错场景,且反复重试仍然报错,可以根据此 logid 及错误码联系扣子团队获取帮助。详细说明可参考获取帮助和技术支持

示例

请求示例

DELETE https://api.coze.cn/v1/conversations/751536489399***/messages/751903981556***/feedback \
--header 'Authorization: Bearer pat_xFWpGsNio4S7sfAzpu02vHCkAdL38VnSsTOIu8CkySdY9Z2xmeM8jjn****' \
--header 'Content-Type: application/json'

返回示例

{
  "code": 0,
  "msg": "",
  "detail": {
    "logid": "20241210191248C8EF76****"
  }
}

错误码

如果成功调用扣子编程的 API,返回信息中 code 字段为 0。如果状态码为其他值,则表示接口调用失败。此时 msg 字段中包含详细错误信息,你可以参考错误码文档查看对应的解决方法。