Skip to main content
POST
Tag workspace members

Authorizations

Authorization
string
header
required

Workspace API key (wk_). GET endpoints require the Workspace read API scope, POST endpoints the Workspace write API scope.

Body

application/json
ids
string[]
required

One or more entity IDs to update (agent IDs, team/group IDs, or user IDs).

Minimum array length: 1
tags
string[]
required

Tag strings to add, remove, or set.

operation
enum<string>

How to apply tags: "add" (default) merges tags in, "remove" deletes listed tags, "set" replaces the full tag list (use an empty array to clear all tags).

Available options:
add,
remove,
set

Response

Success. Empty result sets are also 200.

Batch outcome. The request is 200 as long as it was well-formed; check per-id success for failures.

results
object[]
required
summary
object
required