Create Team Group
Bind a group to a team with a specified role. Every member of the group holds that role on the team. Purely additive: existing grants on the team, including other groups’ bindings and direct user memberships, are unaffected.
Authentication and permissions
Token requirements: User-based token (OAuth) or Organization-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.
- Default request: With a user OAuth token, setting custom_role_id also requires Edit Team Settings on the team.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
The built-in role this group's members get on the team. Required unless custom_role_id is set; then it may be omitted, and if given it must equal that custom role's base role. Purely additive: every other grant on the team — other groups' bindings and direct user memberships, custom roles included — is left untouched.
TEAM_USER_ROLE_UNSPECIFIED, TEAM_USER_ROLE_AGENT, TEAM_USER_ROLE_MANAGER, TEAM_USER_ROLE_BUILDER, TEAM_USER_ROLE_VIEWER, TEAM_USER_ROLE_CONTRIBUTOR, TEAM_USER_ROLE_DRAFTER, TEAM_USER_ROLE_READONLY_AGENT, TEAM_USER_ROLE_APP_BUILDER, TEAM_USER_ROLE_APP_VIEWER, TEAM_USER_ROLE_PERSONAL_TEAM_OWNER Bind the group to one of this team's custom roles instead of a plain built-in role. The binding's role is pinned to the custom role's base role. Requires custom roles to be enabled for the organization.
Response
Success

