diff --git a/content/cloud-docs/api-docs/teams.mdx b/content/cloud-docs/api-docs/teams.mdx index 21373fae49..995cb7e841 100644 --- a/content/cloud-docs/api-docs/teams.mdx +++ b/content/cloud-docs/api-docs/teams.mdx @@ -38,8 +38,6 @@ page_title: Teams - API Docs - Terraform Cloud and Terraform Enterprise -> **Note:** Team management is a paid feature, available as part of the **Team** upgrade package. Single sign-on is also a paid feature, available as part of the **Business** upgrade package. Refer to [Terraform Cloud pricing](https://www.hashicorp.com/products/terraform/pricing) for details. --> **Note:** Single sign-on is a paid feature, available as part of the **Business** upgrade package. [Learn more about Terraform Cloud pricing here](https://www.hashicorp.com/products/terraform/pricing). - The Teams API is used to create, edit, and destroy teams as well as manage a team's organization-level permissions. The [Team Membership API](/cloud-docs/api-docs/team-members) is used to add or remove users from a team. Use the [Team Access API](/cloud-docs/api-docs/team-access) to associate a team with privileges on an individual workspace. Any member of an organization can view visible teams and any secret teams they are a member of. Only organization owners can modify teams or view the full set of secret teams. The organization token and the owners team token can act as an owner on these endpoints. ([More about permissions.](/cloud-docs/users-teams-organizations/permissions)) @@ -79,6 +77,8 @@ $ curl \ ### Sample Response +_The `sso-team-id` attribute is only returned if this team's organization is in the Terraform Cloud Business tier._ + ```json { "data": [ @@ -180,6 +180,8 @@ $ curl \ ### Sample Response +_The `sso-team-id` attribute is only returned if this team's organization is in the Terraform Cloud Business tier._ + ```json { "data": { @@ -241,6 +243,8 @@ $ curl \ ### Sample Response +_The `sso-team-id` attribute is only returned if this team's organization is in the Terraform Cloud Business tier._ + ```json { "data": { @@ -341,6 +345,8 @@ $ curl \ ### Sample Response +_The `sso-team-id` attribute is only returned if this team's organization is in the Terraform Cloud Business tier._ + ```json { "data": { diff --git a/content/cloud-docs/users-teams-organizations/single-sign-on/index.mdx b/content/cloud-docs/users-teams-organizations/single-sign-on/index.mdx index d5131a387c..2eca57617d 100644 --- a/content/cloud-docs/users-teams-organizations/single-sign-on/index.mdx +++ b/content/cloud-docs/users-teams-organizations/single-sign-on/index.mdx @@ -67,7 +67,7 @@ Terraform Cloud can automatically add users to teams based on their SAML asserti If the SAML assertion includes a `MemberOf` attribute, users logging in via SSO are automatically added to the teams included in their assertion and removed from any teams that _aren't_ included in their assertion. This overrides any manually set team memberships; whenever the user logs in, their team membership is adjusted to match their SAML assertion. -Any team names that don't match existing teams are ignored; Terraform Cloud will not automatically create new teams. Terraform Cloud expects the team names in the `MemberOf` SAML attribute to exactly match its own team names. This match is case sensitive. It is not possible to assign users to the `owners` team through this attribute. +Any team names that don't match existing teams are ignored; Terraform Cloud will not automatically create new teams. Terraform Cloud expects the team names in the `MemberOf` SAML attribute to exactly match its own team names or SSO team IDs. This match is case sensitive. It is not possible to assign users to the `owners` team through this attribute. If the `MemberOf` attribute is not provided, users are assigned to a default team named `sso` and are not removed from any existing teams.