Skip to main content
POST
Move agents to a team

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

Agent IDs to update.

Minimum array length: 1
targetTeamId
string | null
required

Team ID to move the agents into, or null for the workspace-global space.

dryRun
boolean

Report what the move would change without moving anything.

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