Merge pull request #24215 from microsoftgraph/main

Merge to publish.

Author: Lauragra

api-reference/beta/api/domain-delete.md

@@ -1,7 +1,7 @@
 ---
 title: "Delete domain"
-description: "Deletes a domain from a tenant."
-author: "adimitui"
+description: "Delete a domain from a tenant."
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
@@ -13,7 +13,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Deletes a domain from a tenant.
+Delete a domain from a tenant.
 
 > **Important:**
 > Deleted domains are not recoverable.

api-reference/beta/api/domain-forcedelete.md

@@ -1,7 +1,7 @@
 ---
 title: "domain: forceDelete"
-description: "Deletes a domain using an asynchronous operation."
-author: "adimitui"
+description: "Delete a domain using an asynchronous operation."
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
@@ -13,9 +13,9 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Deletes a domain using an asynchronous operation.
+Delete a domain using an asynchronous operation.
 
-Prior to calling [forceDelete](domain-forcedelete.md), you must update or remove any references to **Exchange** as the provisioning service.
+Before performing this operation, you must update or remove any references to **Exchange** as the provisioning service.
 
 The following actions are performed as part of this operation:
 
@@ -27,9 +27,9 @@ The following actions are performed as part of this operation:
 
 * If the number of objects to be renamed is greater than 1,000, an error is returned.
 
-* If one of the applications to be renamed is a multi-tenant app, an error is returned.
+* If one of the applications to be renamed is a multitenant app, an error is returned.
 
-After the domain deletion completes, API operations for the deleted domain will return a 404 HTTP response code. To verify deletion of a domain, you can perform a [get domain](domain-get.md). If the domain was successfully deleted, a 404 HTTP response code will be returned in the response.
+After the domain deletion completes, API operations for the deleted domain return a 404 HTTP response code. To verify deletion of a domain, you can perform a [get domain](domain-get.md). If the domain was successfully deleted, a 404 HTTP response code is returned in the response.
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
@@ -65,7 +65,7 @@ In the request body, provide a JSON object with the following parameters.
 
 | Parameter       | Type    |Description|
 |:---------------|:--------|:----------|
-|disableUserAccounts|Boolean| Option to disable renamed user accounts. If a user account is disabled, the user will not be allowed to sign in.<br>*True* (default) - User accounts renamed as part of this operation are disabled.<br>*False* - User accounts renamed as part of this operation are not disabled. |
+|disableUserAccounts|Boolean| Option to disable renamed user accounts. If a user account is disabled, the user isn't allowed to sign in.<br>`true` (default) - User accounts renamed as part of this operation are disabled.<br>`false` - User accounts renamed as part of this operation aren't disabled. |
 
 ## Response
 

api-reference/beta/api/domain-get.md

@@ -1,7 +1,7 @@
 ---
 title: "Get domain"
 description: "Retrieve the properties and relationships of domain object."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-list-domainnamereferences.md

@@ -1,7 +1,7 @@
 ---
 title: "List domainNameReferences"
 description: "Retrieve a list of directoryObject with a reference to the domain."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-list-serviceconfigurationrecords.md

@@ -1,7 +1,7 @@
 ---
 title: "List serviceConfigurationRecords"
 description: "Retrieves a list of domainDnsRecord objects needed to enable services for the domain."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-list-verificationdnsrecords.md

@@ -1,7 +1,7 @@
 ---
 title: "List verificationDnsRecords"
 description: "Retrieve a list of domainDnsRecord objects."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-list.md

@@ -1,7 +1,7 @@
 ---
 title: "List domains"
 description: "Retrieve a list of domain objects."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-post-domains.md

@@ -1,7 +1,7 @@
 ---
 title: "Create domain"
 description: "Adds a domain to the tenant."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-promote.md

@@ -1,7 +1,7 @@
 ---
 title: "domain: promote"
 description: "Promote a verified subdomain to the root domain."
-author: "franqq"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType

api-reference/beta/api/domain-update.md

@@ -1,7 +1,7 @@
 ---
 title: "Update domain"
 description: "Update the properties of domain object."
-author: "adimitui"
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
@@ -13,10 +13,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Update the properties of domain object.
-
-> **Important:**
-> Only verified domains can be updated.
+Update the properties of [domain](../resources/domain.md) object. Only verified domains can be updated.
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 

api-reference/beta/api/domain-verify.md

@@ -1,7 +1,7 @@
 ---
 title: "domain: verify"
-description: "Validates the ownership of the domain."
-author: "adimitui"
+description: "Validate the ownership of a domain."
+author: "tafra00"
 ms.localizationpriority: medium
 ms.subservice: "entra-directory-management"
 doc_type: apiPageType
@@ -13,7 +13,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Validates the ownership of the domain.
+Validate the ownership of a domain.
 
 > **Important:**
 > Only applies to an unverified domain. For an unverified domain, the isVerified property of the [domain](../resources/domain.md) is false.

api-reference/beta/api/group-upsert.md

@@ -19,7 +19,7 @@ You can create or update the following types of group:
 - Microsoft 365 group (unified group)
 - Security group
 
- By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see thethe [Properties](../resources/group.md#properties) section of the [group](../resources/group.md) resource. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) and specify the properties in a `$select` OData query option.
+ By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see the [Properties](../resources/group.md#properties) section of the [group](../resources/group.md) resource. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) and specify the properties in a `$select` OData query option.
 
 > **Note**: To create a [team](../resources/team.md), first create a group, and then add a team to it. For more information, see [Create team](../api/team-put-teams.md).
 

api-reference/beta/api/learningcontent-get.md

@@ -129,6 +129,7 @@ Content-type: application/json
     "numberOfPages": 10,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributors": [
@@ -224,6 +225,7 @@ Content-type: application/json
     "numberOfPages": 10,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributors": [

api-reference/beta/api/learningcontent-update.md

@@ -61,6 +61,7 @@ PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent
 |duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.|
 |externalId|String|Unique external content ID for the learning content. Required.|
 |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.|
+|level|Level|The difficulty level of the learning content. Possible values are: `Beginner`, `Intermediate`, `Advanced`. Optional.|
 |isActive|Boolean|Indicates whether the content is active or not. Inactive content doesn't show up in the UI. The default value is `true`. Optional.|
 |isPremium|Boolean|Indicates whether the learning content requires the user to sign-in on the learning provider platform or not. The default value is `false`. Optional.|
 |isSearchable|Boolean|Indicates whether the learning content is searchable or not. The default value is `true`. Optional.|
@@ -106,6 +107,7 @@ Content-Type: application/json
     "numberOfPages": 9,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00Z",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributors": ["Scott Simpson"],
@@ -180,6 +182,7 @@ Content-Type: application/json
     "numberOfPages": 9,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributors": [
@@ -230,6 +233,7 @@ Content-Type: application/json
     "numberOfPages": 9,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributor": "Scott Simpson",
@@ -304,6 +308,7 @@ Content-Type: application/json
     "numberOfPages": 9,
     "duration": "PT20M",
     "format": "Book",
+    "level": "Beginner",
     "createdDateTime": "2018-01-01T00:00:00",
     "lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
     "contributors": [

api-reference/beta/api/search-searchentity-post-bookmarks.md

@@ -72,7 +72,6 @@ If successful, this method returns a `201 Created` response code with the ID of
 
 The following example shows a request.
 
-# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "create_bookmark_from_bookmarks_e1"
@@ -87,7 +86,7 @@ Content-Type: application/json
   "description": "Try or buy Contoso for Home or Business and view product information",
   "keywords":  {
     "keywords": ["Contoso", "install"],
-    "reservedKeywords": ["Contoso"],
+    "reservedKeywords": ["Unique keyword"],
     "matchSimilarKeywords": true
   },
   "availabilityStartDateTime": null,
@@ -104,40 +103,6 @@ Content-Type: application/json
 }
 ```
 
-# [C#](#tab/csharp)
-[!INCLUDE [sample-code](../includes/snippets/csharp/create-bookmark-from-bookmarks-e1-csharp-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [CLI](#tab/cli)
-[!INCLUDE [sample-code](../includes/snippets/cli/create-bookmark-from-bookmarks-e1-cli-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Go](#tab/go)
-[!INCLUDE [sample-code](../includes/snippets/go/create-bookmark-from-bookmarks-e1-go-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Java](#tab/java)
-[!INCLUDE [sample-code](../includes/snippets/java/create-bookmark-from-bookmarks-e1-java-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [JavaScript](#tab/javascript)
-[!INCLUDE [sample-code](../includes/snippets/javascript/create-bookmark-from-bookmarks-e1-javascript-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PHP](#tab/php)
-[!INCLUDE [sample-code](../includes/snippets/php/create-bookmark-from-bookmarks-e1-php-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PowerShell](#tab/powershell)
-[!INCLUDE [sample-code](../includes/snippets/powershell/create-bookmark-from-bookmarks-e1-powershell-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Python](#tab/python)
-[!INCLUDE [sample-code](../includes/snippets/python/create-bookmark-from-bookmarks-e1-python-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
----
-
 ### Response
 
 The following example shows the response.

api-reference/beta/api/virtualevent-cancel.md

@@ -0,0 +1,81 @@
+---
+title: "virtualEvent: cancel"
+description: "Cancel a virtual event."
+author: "awang119"
+ms.localizationpriority: medium
+ms.subservice: "cloud-communications"
+doc_type: apiPageType
+---
+
+# virtualEvent: cancel
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Cancel a virtual event.
+
+Currently the supported virtual event type is [virtualEventTownhall](../resources/virtualeventtownhall.md). A canceled town hall has its **status** set to `canceled` permanently. You can still get a canceled town hall by using the [Get virtualEventTownhall](../api/virtualeventtownhall-get.md) API.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+<!-- {
+  "blockType": "permissions",
+  "name": "virtualevent-cancel-permissions"
+}
+-->
+[!INCLUDE [permissions-table](../includes/permissions/virtualevent-cancel-permissions.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/virtualEvents/townhalls/{townhallId}/cancel
+```
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "virtualeventthis.cancel",
+  "sampleKeys": ["bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/virtualEvents/townhalls/bce9a3ca-a310-48fa-baf3-1cedcd04bb3f@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba/cancel
+```
+
+### Response
+
+The following example shows the response.
+
+<!-- {
+  "blockType": "response",
+  "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```