删除会话条目¶

删除本地会话中的一条条目；删除后无法再查询该条目。

DELETE https://token.moi.matrixorigin.cn/v1/conversations/{conversation_id}/items/{item_id}

调用前准备¶

准备具有 Genesis 权限的个人访问令牌。
使用创建会话时的凭据，选择尚未删除、尚未关联上游模型的本地会话。
选择通过添加会话条目或查询会话条目列表取得的条目。

使用数据面凭据：部署启用的本地 sk-mo Key、UC 个人访问令牌、服务账号 API Key 或已验证的服务账号 OAuth 令牌；普通用户 OAuth、管理 JWT 和 Cookie 不能直接替代。只提交一个认证来源，不在查询参数携带凭据。模型调用还受允许模型、用户可用模型与套餐范围共同约束；OAuth 服务账号模型执行可能返回 runtime_not_ready。认证可能更新最近调用时间或身份策略投影，读取接口也不保证无写入。

请求示例¶

示例中的凭据和资源标识需替换为当前调用者的实际值。

curl -X DELETE "https://token.moi.matrixorigin.cn/v1/conversations/$CONVERSATION_ID/items/$ITEM_ID" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"

路径参数¶

参数	类型	是否必填	说明
`conversation_id`	string	是	创建会话响应中的 `id`。
`item_id`	string	是	目标条目的 `id`，必须属于指定会话。

成功响应¶

成功时返回删除确认，之后不能再查询该条目。

响应示例

{
  "id": "$ITEM_ID",
  "object": "conversation.item.deleted",
  "deleted": true
}

字段说明

字段	类型	说明
`id`	string	已删除资源的标识。
`object`	string	删除结果类型。
`deleted`	boolean	成功删除时为 `true`。

错误响应¶

资源不存在、已删除或当前凭据不可访问时，请求返回 404。

响应示例

{
  "error": {
    "message": "conversation item not found",
    "type": "conversation_item_not_found",
    "code": "conversation_item_not_found"
  }
}

字段说明

字段	类型	说明
`error`	object	错误信息。
`error.message`	string	错误原因。
`error.type`	string	错误类别。
`error.code`	string	错误代码。

最后更新于 2026 年 10 月 15 日