Merge pull request #26087 from microsoftgraph/FaithOmbongi-patch-2

Update ms.subservice and TOC position for Entra ExtID invitation APIs

Author: Danielabom

api-reference/beta/api/invitation-post.md

@@ -3,7 +3,7 @@ title: "Create invitation"
 description: "Create a new invitation or reset the redemption status for a guest user. The invitation adds an external user to the organization."
 ms.localizationpriority: medium
 author: "ppolkadots"
-ms.subservice: "entra-sign-in"
+ms.subservice: "entra-users"
 doc_type: apiPageType
 ms.date: 10/17/2024
 ---

api-reference/beta/resources/identity-network-access-overview.md

@@ -27,7 +27,7 @@ Microsoft Entra is a family of identity and network access capabilities that are
 
 ## Manage user identities
 
-Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users).
+Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, including guests, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users).
 
 ## Manage groups
 
@@ -89,7 +89,6 @@ A core functionality of identity and access management is managing your tenant c
 |Force autoacceleration sign-in to skip the username entry screen and automatically forward users to federated sign-in endpoints |[homeRealmDiscoveryPolicy resource type](homerealmdiscoverypolicy.md) resource type and its associated APIs|
 | Detect, investigate, and remediate identity-based risks using Microsoft Entra ID Protection and feed the data into security information and event management (SIEM) tools for further investigation and correlation | See [Use the Microsoft Graph identity protection APIs](identityprotection-overview.md) |
 | Manage identity providers for Microsoft Entra ID, Microsoft Entra External ID, and Azure AD B2C tenants. You can perform the following operations: <li> Manage identity providers for external identities, including social identity providers, OIDC, Apple, SAML/WS-Fed, and built-in providers <li> Manage configuration for federated domains and token validation | [identityProviderBase resource type](identityproviderbase.md) and its associated APIs |
-| Invite external users to collaborate with your tenant by using Microsoft Entra External ID | [invitation resource type](invitation.md) and its associated APIs |
 | Stay informed about Microsoft Entra product lifecycle updates, including the product roadmap and change announcements | See <li>[changeItemBase resource type](changeitembase.md) and its associated APIs for product updates <li> [announcement resource type](announcement.md) and its associated APIs for change annoncements <li> [roadmap resource type](roadmap.md) and its associated APIs for product roadmap information  |
 | Define a group of tenants belonging to your organization and streamline intra-organization cross-tenant collaboration | See [Multitenant organization API overview](multitenantorganization-overview.md) |
 | Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs |

api-reference/beta/resources/invitation.md

@@ -1,9 +1,9 @@
 ---
 title: "invitation resource type"
-description: "Represents an invitation that is used to add external users to an organization as part of Microsoft Entra business-to-business (Microsoft Entra B2B) collaboration."
+description: "Represents an invitation that is used to add external users to an organization as part of B2B collaboration in Microsoft Entra External ID."
 ms.localizationpriority: medium
 author: "ppolkadots"
-ms.subservice: "entra-sign-in"
+ms.subservice: "entra-users"
 doc_type: resourcePageType
 ms.date: 06/06/2024
 ---
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Represents an invitation that is used to add external users to an organization as part of Microsoft Entra business-to-business (Microsoft Entra B2B) collaboration.
+Represents an invitation that is used to add external users to an organization as part of business-to-business (B2B) collaboration in Microsoft Entra External ID.
 
 The invitation process uses the following flow:
 

api-reference/beta/resources/users.md

@@ -24,6 +24,8 @@ You can access users through Microsoft Graph in two ways:
 
 ## Common API operations
 
+In Microsoft Graph, users are represented by the [user](../resources/user.md) resource type. The following table lists common operations that you can perform on users.
+
 | Path | Description |
 |--|--|
 | [`/me`](../api/user-get.md) | Get the signed-in user's details. |
@@ -36,6 +38,7 @@ You can access users through Microsoft Graph in two ways:
 | [`/users/{id}/drive`](../api/drive-get.md) | Gets the user's OneDrive file store. |
 | [`/users/{id}/memberOf`](../api/user-list-memberof.md) | Lists the groups that the user is a member of. |
 | [`/users/{id}/joinedTeams`](../api/user-list-joinedteams.md) | Lists the Microsoft Teams that the user is a member of. |
+| [`POST /invitations`](../api/invitation-post.md) | Invite a guest as part of business-to-business (B2B) collaboration in Microsoft Entra External ID |
 
 ## Authorization and privileges
 

api-reference/beta/toc/identity-and-access/toc.yml

@@ -2844,12 +2844,6 @@ items:
         href: ../../api/identityprovider-list-availableprovidertypes.md
     - name: OpenID Connect identity provider (deprecated)
       href: ../../resources/openidconnectprovider.md
-  - name: Invitation
-    items:
-    - name: Invitation
-      href: ../../resources/invitation.md
-    - name: Create
-      href: ../../api/invitation-post.md
   - name: Microsoft Entra lifecycle announcements
     items:
     - name: Product changes

api-reference/beta/toc/toc.mapping.json

@@ -4,7 +4,8 @@
       "name": "Users",
       "overview": "../../resources/users.md",
       "resources": [
-        "user"
+        "user",
+        "invitation"
       ]
     },
     {
@@ -1461,8 +1462,7 @@
             "dataPolicyOperation",
             "oAuth2PermissionGrant",
             "certificateBasedAuthConfiguration",
-            "externalIdentitiesPolicy",
-            "invitation"
+            "externalIdentitiesPolicy"
           ],
           "childNodes": [
             {

api-reference/beta/toc/users/toc.yml

@@ -298,3 +298,9 @@ items:
       href: ../../api/usersettings-get.md
     - name: Update
       href: ../../api/usersettings-update.md
+- name: Invitation
+  items:
+  - name: Invitation
+    href: ../../resources/invitation.md
+  - name: Create
+    href: ../../api/invitation-post.md

api-reference/v1.0/api/invitation-post.md

@@ -3,7 +3,7 @@ title: "Create invitation"
 description: "Create a new invitation or reset the redemption status for a guest user. The invitation adds an external user to the organization."
 ms.localizationpriority: high
 author: "ppolkadots"
-ms.subservice: "entra-sign-in"
+ms.subservice: "entra-users"
 doc_type: apiPageType
 ms.date: 10/17/2024
 ---

api-reference/v1.0/resources/identity-network-access-overview.md

@@ -27,7 +27,7 @@ Microsoft Entra is a family of identity and network access capabilities that are
 
 ## Manage user identities
 
-Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users).
+Users are the main identities in any identity and access solution. You can manage the entire lifecycle of users in your organization, including guests, and their entitlements like licenses or group memberships, using Microsoft Graph APIs. For more information, see [Working with users in Microsoft Graph](/graph/api/resources/users).
 
 ## Manage groups
 
@@ -82,7 +82,6 @@ A core functionality of identity and access management is managing your tenant c
 |Force autoacceleration sign-in to skip the username entry screen and automatically forward users to federated sign-in endpoints |[homeRealmDiscoveryPolicy resource type](homerealmdiscoverypolicy.md) resource type and its associated APIs|
 | Detect, investigate, and remediate identity-based risks using Microsoft Entra ID Protection and feed the data into security information and event management (SIEM) tools for further investigation and correlation | See [Use the Microsoft Graph identity protection APIs](identityprotection-overview.md) |
 | Manage identity providers for Microsoft Entra ID, Microsoft Entra External ID, and Azure AD B2C tenants. You can perform the following operations: <li> Manage identity providers for external identities, including social identity providers, OIDC, Apple, SAML/WS-Fed, and built-in providers <li> Manage configuration for federated domains and token validation | [identityProviderBase resource type](identityproviderbase.md) and its associated APIs |
-| Invite external users to collaborate with your tenant by using Microsoft Entra External ID | [invitation resource type](invitation.md) and its associated APIs |
 | Define a group of tenants belonging to your organization and streamline intra-organization cross-tenant collaboration | See [Multitenant organization API overview](multitenantorganization-overview.md) |
 | Customize sign-in UIs to match your company branding, including applying branding that's based on the browser language | [organizationalBranding resource type](organizationalbranding.md) and its associated APIs |
 | User flows for Microsoft Entra External ID in workforce tenants | The following resource types and their associated APIs: <li>[b2xIdentityUserFlow](b2xidentityuserflow.md) to configure the base user flow and its properties such as identity providers <li> [identityUserFlowAttribute](identityuserflowattribute.md) to manage built-in and custom user flow attributes <li> [identityUserFlowAttributeAssignment](identityuserflowattributeassignment.md) to manage user flow attribute assignments <li> [userFlowLanguageConfiguration resource type](userflowlanguageconfiguration.md) to configure custom languages for user flows |

api-reference/v1.0/resources/invitation.md

@@ -1,9 +1,9 @@
 ---
 title: "invitation resource type"
-description: "Represents an invitation that is used to add external users to an organization as part of Microsoft Entra business-to-business (Microsoft Entra B2B) collaboration."
+description: "Represents an invitation that is used to add external users to an organization as part of B2B collaboration in Microsoft Entra External ID."
 ms.localizationpriority: high
 author: "ppolkadots"
-ms.subservice: "entra-sign-in"
+ms.subservice: "entra-users"
 doc_type: resourcePageType
 ms.date: 06/05/2024
 ---
@@ -12,7 +12,7 @@ ms.date: 06/05/2024
 
 Namespace: microsoft.graph
 
-Represents an invitation that is used to add external users to an organization as part of Microsoft Entra business-to-business (Microsoft Entra B2B) collaboration.
+Represents an invitation that is used to add external users to an organization as part of business-to-business (B2B) collaboration in Microsoft Entra External ID.
 
 The invitation process uses the following flow: