RenameSource - 更改指定数据源的名称

更新时间:
复制 MD 格式

用于更改指定数据源的名称,支持轻量级操作。

接口说明

请求说明

  • 该 API 仅更新数据源的 name 字段,不会触发 process_source。

  • 成功后会发布 SOURCE_CHANGED 事件供前端刷新显示。

  • 将尽力通知 DocumentAgent 同步新的 source_name,即使同步失败也不会阻断主流程。

  • 如果指定的数据源不存在,则抛出 ERR.Robject.Source.NotFound 错误,并由全局中间件统一转换为 POP 错误码。

  • 安全约束:tenant_id 和 user_id 必须来自鉴权身份。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /openapi/renameSource HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

tenantId

string

否

租户 ID,公共参数;winnexo-cli 通过 --tenant-id 显式传入。

10000

sourceId

string

否

数据源 ID(租户内唯一)。

exampleSourceId

newName

string

否

新的数据源名称。

string_value

返回参数

名称

类型

描述

示例值

object

重命名数据源。

code

string

响应状态码。

200

message

string

状态码描述。

successful

requestId

string

请求追踪 ID。

019FF406-1B10-0065-A97D-2D1920C2A03D

sourceId

string

数据源 ID。

exampleSourceId

name

string

文件名。

示例名称.pdf

status

string

数据源状态

READY

gmtModified

string

最近修改时间,ISO8601 格式

string_value

示例

正常返回示例

JSON格式

{
  "code": "200",
  "message": "successful",
  "requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
  "sourceId": "exampleSourceId",
  "name": "示例名称.pdf",
  "status": "READY",
  "gmtModified": "string_value"
}

错误码

访问错误中心错误中心查看更多错误码。

变更历史

更多信息,参考变更详情变更详情。