Batch Update File Tags

Update tags on multiple files in one call. Supports overwrite and append modes.

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": ["product", "V2"]},
      {"fileId": "file_def456", "tags": ["FAQ"]}
    ],
    "updateMode": "OVERWRITE"
  }'

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

The two updateMode values: OVERWRITE replaces a file's existing tags entirely; APPEND adds to the existing tags.

Authorizations

string

header

required

DashScope API Key, obtained from the API Key page in the console.

Body

application/json

object[]

required

File tag information list.

Required range:items: 1–20

Show child attributes

string

required

File ID. Returned by listFile.

string[]

required

Tag list.

Required range:items: 1–100

enum<string>

Update mode — OVERWRITE (replace existing tags), APPEND (add to existing tags), REMOVE (delete the listed tags).

Available options:OVERWRITE,APPEND

Response

200-application/json

string

Response code. Success on success.

string

Error or informational message; an empty string on success.

string

Unique request identifier. Include this ID when reporting an issue.

object

Per-file update results.

Show child attributes

object[]

List of per-file update results.

Show child attributes

string

File ID.

boolean

Whether tags were updated successfully for this file.

integer

Business status code. 200 on success, 400 for failures such as invalid parameters. Note that the HTTP status code remains 200 even on failure, so rely on this field and code to determine the result.

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": ["product", "V2"]}, {"fileId": "file_def456", "tags": ["FAQ"]} ], "updateMode": "OVERWRITE" }'