Get team

Fetch a team by key.

Expanding the teams response

LaunchDarkly supports several fields for expanding the “Get 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.
  • roleAttributes includes a list of the role attributes 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.

Path parameters

teamKeystringRequired
The team key.

Headers

AuthorizationstringRequired

Query parameters

expandstringOptional

A comma-separated list of properties that can reveal additional information in the response.

Response

Teams response
descriptionstring or null
A description of the team
keystring or null
The team key
namestring or null

A human-friendly name for the team

_accessobject or null
Details on the allowed and denied actions for this team
_creationDatelong or null
Timestamp of when the team was created
_lastModifiedlong or null
Timestamp of when the team was most recently updated
_versioninteger or null
The team version
_idpSyncedboolean or null

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 strings or null
A map of role attributes for the team
rolesobject or null

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

membersobject or null

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

projectsobject or null

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

maintainersobject or null

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

Errors