用于更改指定企业知识库内数据源的名称。
接口说明
请求说明
该接口允许具有相应权限的用户修改企业知识库中的特定数据源名称。
需要提供待修改的数据源 ID(
sourceId)及新的名称(newName)。修改操作仅更新数据源的名字字段,不会触发其他处理流程。
成功执行后,系统会发布
SOURCE_CHANGED事件以供前端刷新显示,并尝试通知 DocumentAgent 同步最新的 source_name 信息,但此步骤失败不会影响主流程的完成状态。如果提供的
sourceId不存在,则返回错误码ERR.Robject.Source.NotFound。此 API 调用需具备
DEVELOPMENT_KB_MANAGE功能权限。支持通过 AK、BearerToken 或 APP 方式进行身份验证。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /openapi/renameKnowledgeBaseSource 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 |
最后更新时间。 |
string_value |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "successful",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"sourceId": "exampleSourceId",
"name": "示例名称.pdf",
"status": "READY",
"gmtModified": "string_value"
}