更新会话信息¶

替换本地会话的全部自定义信息。

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

调用前准备¶

准备具有 Genesis 权限的个人访问令牌。
使用创建会话时的凭据，选择尚未删除、尚未关联上游模型的本地会话。

认证方式见 Genesis 凭据规则。

请求体¶

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

输入示例

curl -X POST "https://token.moi.matrixorigin.cn/v1/conversations/$CONVERSATION_ID" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "purpose": "support"
  }
}'

参数说明

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

请求体

参数	类型	是否必填	说明
`metadata`	object	否	会话的自定义信息，会完整替换原有信息。省略此字段或传入 `{}` 时，会清空这些信息。
`metadata.<key>`	any	否	自定义键和值，例如 `purpose`。

请求体必须为 JSON 对象。

成功响应¶

响应示例

{
  "id": "$CONVERSATION_ID",
  "object": "conversation",
  "metadata": {
    "purpose": "support"
  },
  "status": "active",
  "created_at": 1780000000,
  "updated_at": 1780000000
}

字段说明

字段	类型	说明
`id`	string	会话标识，用于查询、更新和删除会话。
`object`	string	固定为 `conversation`。
`metadata`	object	会话的自定义信息。已保存的值不是 JSON 对象时，返回 `{}`。
`metadata.<key>`	any	自定义键和值，例如 `purpose`。
`status`	string	会话状态，创建后为 `active`。
`created_at`	integer	创建时间，Unix 秒级时间戳。
`updated_at`	integer	最后更新时间，Unix 秒级时间戳。

错误响应¶

资源不存在、已删除或当前凭据不可访问时，请求返回 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 日