Organizations

GetTeam

Retrieves detailed information about a specific team within an organization. The response includes the team name, display name, description, team type (Pulumi-managed, GitHub-backed, or GitLab-backed), list of members with their roles (team admin or team member), and the stack permissions granted to the team. Teams provide a centralized way to manage stack access for groups of users.

get/api/orgs/{orgName}/teams/{teamName}

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/orgs/{orgName}/teams/{teamName}
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

teamNamestring required

The team name

Response

OK

descriptionstring required

A free-form text description of the team's purpose.

displayNamestring required

The human-readable display name shown in the UI.

kind'github' | 'pulumi' | 'scim' required

The kind of team (e.g., pulumi or GitHub-backed).

listMembersErrorstring

ListMembersError is the error message if an error was encountered whilst trying to contact the team's backend (eg. GitHub). The UI will only show this error if it is non-nil and if Members itself is an empty slice.

namestring required

The unique identifier name of the team within the organization.

roleIdsstring[]

RoleIDs are the IDs of the FGA roles assigned to the team, if any. Currently only one role per team is supported.

userRole'none' | 'member' | 'admin'

UserRole is the calling user's role on the given team.

Changes

No recorded changes to this operation across all 1 revision of this API.