OverviewTeams

Create team

Create a team. To learn more, read Creating a team.

Expanding the teams response

LaunchDarkly supports four fields for expanding the “Create team” response. By default, these fields are not included in the response.

To expand the response, append the expand query parameter and add a comma-separated list with any of the following fields:

  • members includes the total count of members that belong to the team.
  • roles includes a paginated list of the custom roles that you have assigned to the team.
  • projects includes a paginated list of the projects that the team has any write access to.
  • maintainers includes a paginated list of the maintainers that you have assigned to the team.

For example, expand=members,roles includes the members and roles fields in the response.

Headers

AuthorizationstringRequired

Query parameters

expandstringOptional

A comma-separated list of properties that can reveal additional information in the response. Supported fields are explained above.

Request

This endpoint expects an object.
keystringRequired
The team key
namestringRequired

A human-friendly name for the team

customRoleKeyslist of stringsOptional
List of custom role keys the team will access
descriptionstringOptional
A description of the team
memberIDslist of stringsOptional
A list of member IDs who belong to the team
permissionGrantslist of objectsOptional
A list of permission grants. Permission grants allow access to a specific action, without having to create or update a custom role.
roleAttributesmap from strings to lists of stringsOptional
A map of role attributes for the team

Response

Teams response
descriptionstringOptional
A description of the team
keystringOptional
The team key
namestringOptional

A human-friendly name for the team

_accessobjectOptional
Details on the allowed and denied actions for this team
_creationDatelongOptional
Timestamp of when the team was created
_lastModifiedlongOptional
Timestamp of when the team was most recently updated
_versionintegerOptional
The team version
_idpSyncedbooleanOptional

Whether the team has been synced with an external identity provider (IdP). Team sync is available to customers on an Enterprise plan.

roleAttributesmap from strings to lists of stringsOptional
A map of role attributes for the team
rolesobjectOptional

Paginated list of the custom roles assigned to this team. Only included if specified in the expand query parameter.

membersobjectOptional

Details on the total count of members that belong to the team. Only included if specified in the expand query parameter.

projectsobjectOptional

Paginated list of the projects that the team has any write access to. Only included if specified in the expand query parameter.

maintainersobjectOptional

Paginated list of the maintainers assigned to this team. Only included if specified in the expand query parameter.

Errors