# 批量设置浏览器环境标签

覆盖所选资源的标签。需要标签管理权限及目标资源访问权限。按团队内的精确名称匹配标签：不存在则创建，已存在则复用并更新颜色；颜色变化也会影响使用同一标签的其他资源。请求中的标签名称不能重复。`tags` 传空数组仅清空标签关联，保留标签定义与分组。同步完成，`data` 为 null。超时后先查询目标资源及 `/api/envtag/all` 再决定是否重试；接口没有幂等键。
已记录的业务错误码：`15003`, `15004`, `19039`, `19173`, `19193`。 各错误码的含义见 [Error Codes](/zh/api-reference/getting-started/error-codes)。任何接口还可能返回通用错误码。

Endpoint: POST /api/env/setTags/batch
Version: 2026-09-05

## Request fields (application/json):

  - `envIds` (array)
    浏览器环境 ID。`envIds` 或 `uniqueIds` 至少一个为非空数组；非空 `envIds` 优先。沿用现有批量环境选择及权限校验规则解析目标。

  - `uniqueIds` (array)
    浏览器环境序号；envIds 为空或省略时使用。

  - `tags` (array, required)
    覆盖全部现有标签关联的标签列表。空数组清空关联，但不删除标签定义。

  - `tags.tagName` (string, required)
    团队内精确匹配的标签名称。同一请求中名称不能重复。

  - `tags.tagColor` (any)
    标签颜色。省略或空白时使用 red；只支持颜色名称，不支持十六进制色值。

## Request examples:

  - `replace` (unknown)

  - `clear` (unknown)

  - `bySerialNumber` (unknown)

## Response 200:

  - `200` (unknown)
    成功。标签关联已同步更新，data 为 null。

## Response 200 fields (application/json):

  - `code` (integer)
    Example: 0

  - `msg` (string | null)

  - `requestId` (string)

  - `data` (null)

