Update teams
Perform a partial update to multiple teams. Updating teams uses the semantic patch format.
To make a semantic patch request, you must append domain-model=launchdarkly.semanticpatch
to your Content-Type
header. To learn more, read Updates using semantic patch.
Instructions
Semantic patch requests support the following kind
instructions for updating teams.
Click to expand instructions for updating teams
addMembersToTeams
Add the members to teams.
Parameters
memberIDs
: List of member IDs to add.teamKeys
: List of teams to update.
Here’s an example:
addAllMembersToTeams
Add all members to the team. Members that match any of the filters are excluded from the update.
Parameters
teamKeys
: List of teams to update.filterLastSeen
: (Optional) A JSON object with one of the following formats:{"never": true}
- Members that have never been active, such as those who have not accepted their invitation to LaunchDarkly, or have not logged in after being provisioned via SCIM.{"noData": true}
- Members that have not been active since LaunchDarkly began recording last seen timestamps.{"before": 1608672063611}
- Members that have not been active since the provided value, which should be a timestamp in Unix epoch milliseconds.
filterQuery
: (Optional) A string that matches against the members’ emails and names. It is not case sensitive.filterRoles
: (Optional) A|
separated list of roles and custom roles. For the purposes of this filtering,Owner
counts asAdmin
.filterTeamKey
: (Optional) A string that matches against the key of the team the members belong to. It is not case sensitive.ignoredMemberIDs
: (Optional) A list of member IDs.
Here’s an example:
Headers
Request
The instructions to perform when updating. This should be an array with objects that look like <code>{“kind”: “update_action”}</code>. Some instructions also require additional parameters as part of this object.
Optional comment describing the update
Response
Teams response
A list of member IDs of the members who were added to the teams.
A list of team keys of the teams that were successfully updated.
A list of team keys and errors for the teams whose updates failed.