Organizations

CreateGitHubTeam

Creates a new Pulumi team backed by a GitHub team. When an organization is backed by GitHub, existing GitHub teams can be imported into Pulumi to manage stack permissions. Membership is managed through GitHub while stack access permissions are controlled within Pulumi Cloud. The request must include the GitHub team ID. Returns 409 if a team with the same name already exists.

post/api/orgs/{orgName}/teams/github

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/github
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Request body

githubTeamIDinteger required

GitHubTeamID is the GitHub ID of the team to mirror. Must be in the same GitHub organization that the Pulumi org is backed by.

Response

Created

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.