Skip to content

Batch set browser profile tags

Request

Overwrite tags on the selected resources. Requires tag-management permission and access to the targets. Tags are matched by exact name within the team: missing tags are created, existing tags are reused and their color is updated. This color change also affects other resources using the same tag. Names must be unique within the request. An empty tags array clears only tag assignments; tag definitions and groups are retained. Completion is synchronous and data is null. After a timeout, query the target resources and /api/envtag/all before retrying; there is no idempotency key.

Documented business errors: 15003, 15004, 19039, 19173, 19193. See Error Codes for what each code means. Any operation can additionally return the common codes.

Bodyapplication/jsonrequired
Any of:
envIdsArray of strings, non-emptyrequired

Browser profile IDs. Provide a non-empty envIds or uniqueIds; non-empty envIds takes precedence. Targets are resolved using the existing batch-profile selection and permission rules.

uniqueIdsArray of integers

Browser profile serial numbers, used when envIds is empty or omitted.

Example:
[ 1 ]
tagsArray of objectsrequired

Tags replacing all current tag assignments. An empty array clears assignments without deleting tag definitions.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setTags/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "envIds": [
      "1993244721490239488"
    ],
    "tags": [
      {
        "tagName": "Sales",
        "tagColor": "blue"
      }
    ]
  }'

Responses

Success. Tag assignments have been updated synchronously; data is null.

Bodyapplication/json
codeinteger
Example:0
msgstring or null
requestIdstring
datanull
Response
{ "code": 0, "msg": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d", "data": null }