批量更新文件标签 - Knowledge Studio

批量更新多个文件的标签，支持覆盖和追加两种模式

POST

/api/v1/connector/dash/batchUpdateFileTag

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/batchUpdateFileTag" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileInfos": [
      {"fileId": "file_abc123", "tags": ["产品", "V2"]},
      {"fileId": "file_def456", "tags": ["FAQ"]}
    ],
    "updateMode": "OVERWRITE"
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {},
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

updateMode 的两种模式：OVERWRITE 会替换文件的全部现有标签；APPEND 在现有标签基础上追加。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://rag.console.aliyun.com/settings/apikey）获取。

Body

application/json

object[]

required

文件标签信息列表。

Required range:items: 1–20

Show child attributes

string

required

文件 ID，通过 listFile 获取。

string[]

required

文件关联的标签列表。最多传入 100 个标签，所有标签字符长度总和不超过 700，单个标签最多 32 个字符。

Required range:items: 1–100

enum<string>

更新模式：OVERWRITE（覆盖现有标签）、APPEND（追加标签）。

Available options:OVERWRITE,APPEND

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

更新成功时无返回数据。