Add and remove teammates on a team

This operation adds teammates to and removes teammates from a team identified by id in a single request. Either all of the changes are applied or, if any id is invalid, none of them are.

Only active teammates in your organization can be added; suspended teammates cannot be newly added to a team, but they can be removed. Teammates in addMemberIds who are already on the team (including suspended teammates), and teammates in removeMemberIds who are not on the team, are ignored, so repeating a request or sending back the current member list is safe. An id cannot appear in both lists.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the team

Body Params

At least one of addMemberIds or removeMemberIds must be non-empty, with at most 100 ids across both lists.

addMemberIds
array of objects
length ≤ 100

The ids of the teammates to add to the team

addMemberIds
removeMemberIds
array of objects
length ≤ 100

The ids of the teammates to remove from the team

removeMemberIds
Headers
string

A unique value generated by the client used to recognize subsequent retries of the same request. Idempotency keys can be up to 255 characters long.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json