Update user's team assignments

Replaces the user’s manual team assignments. Synced team memberships (from SCIM providers) are preserved and cannot be removed via this endpoint.

PUT /api/users/{id}/teams

Error

A valid request URL is required to generate request examples

200

{
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id · string · required

User ID

Body

application/json

team_ids · string[] · required

List of team IDs to assign (replaces existing manual assignments; synced memberships are preserved)

Response

200

application/json

Teams updated successfully

Simple message response

message · string