Skip to main content

修改会话名称

千问办公企业旗舰版开发者文档:修改会话名称。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务
  • 接口:PATCH/api/openapi/app/v1/sessions/{session_id}
  • operationId:rename-session

接口说明

只修改 name。沿用原名称规则:1~50个字符,允许各语言字母、数字、空格、下划线、连字符、点及 U+0300~U+036F 组合附加符号;首尾空白会被去除。原始输入超过50字符、空名称、未知字段和修改身份/状态/运行配置均返回422。复用原名称审核与持久化流程。

请求参数

字段类型必填说明
session_id (path)string是创建会话接口返回的会话 ID。

请求体

字段类型必填说明
namestring是显示名称,仅允许字母、数字、组合标记、空格、连字符、下划线和点;长度 1~50 个字符。

成功响应

HTTP 200

字段类型必填说明
namestring是见接口说明
session_idstring是见接口说明

错误与边界

401:入口身份无效;404:资源不存在、已删除或非本人;422:输入无效;503:所需依赖未装配或暂不可用。业务状态和审核拒绝按服务端错误体处理。 本接口不接受调用方传入身份来改变归属,不暴露内部 extra_data、沙箱凭据或模型 runtime 配置。写入超时后先查询实际状态,不把超时视为操作未发生。