更新时间:2025-07-22 GMT+08:00
分享

更新文档元数据信息

功能介绍

更新文档元数据信息。

URI

PUT /v1/{project_id}/applications/{application_id}/uni-search/{repo_id}/files/{file_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

application_id

String

参数解释:

应用ID,获取方法请参见获取应用ID

约束限制:

字符串

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

repo_id

String

参数解释:

知识库ID。

获取方式:

账号登录KooSearch体验平台,在左侧导航栏选择:"知识库管理" ,在此界面获取"知识库ID"字段的值,表示该知识库在向量数据库中存储的ID,具有唯一性。

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线。

默认取值:

不涉及

file_id

String

参数解释:

文件ID。

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线。

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

category

String

参数解释:

文档目录,单值,对应目录树中的叶子节点。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

tags

Array of strings

参数解释:

标签列表。其中每个tag只能包含1到255位英文字母、中文、数字、中划线或者下划线,并且以字母、数字或者中文开头。

约束限制:

25.2.T1版本增加URL常用特殊字符::/.?&=@#%+~!$'(),;*[] 等特殊字符。

取值范围:

不涉及

默认取值:

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

接口鉴权使用的Token,Token获取方式参考:获取IAM用户Token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

file_id

String

参数解释:

上传文件的id。

取值范围:

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

请求示例

表单格式

/v1/b25446daeb1a41a7953c5deba2b2677a/applications/cefb2a59-2f9e-4268-b56b-eab15dc0b9d6/uni-search/0e7a261c-a543-4f98-915d-7a83ac96595c/files/7bb4d9351fa8a00cd30782bfd29a1766

响应示例

状态码:200

更新后文档元数据。

{
  "file_id" : "7bb4d9351fa8a00cd30782bfd29a1766"
}

状态码

状态码

描述

200

更新后文档元数据。

400

参数错误。

500

内部异常。

错误码

请参见错误码

相关文档