删除会话

删除本地会话。删除后无法再通过会话接口访问该会话及其条目。

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

调用前准备

1. 准备具有 Genesis 权限的个人访问令牌。

2. 使用创建会话时的凭据，选择尚未删除、尚未关联上游模型的本地会话。

认证方式见 Genesis 凭据规则。

请求参数

将示例中的 $CONVERSATION_ID、$GENESIS_ACCESS_TOKEN 替换为实际值。

输入示例

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

参数说明

参数	类型	是否必填	说明
conversation_id	string	是	创建会话响应中的 id。

成功响应

响应示例

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

字段说明

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

错误响应

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

响应示例

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

字段说明

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

最后更新于 2026 年 10 月 19 日