Merge pull request #25825 from microsoftgraph/ReviewSetTagsdocumentation

Review Set Tags Documentation

Author: Danielabom

api-reference/beta/api/security-ediscoverycase-list-tags.md

@@ -25,10 +25,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 
 ## HTTP request
 
-<!-- {
-  "blockType": "ignored"
-}
--->
 ``` http
 GET /security/cases/ediscoveryCases/{ediscoveryCaseId}/tags
 ```
@@ -47,14 +43,15 @@ If successful, this method returns a `200 OK` response code and a collection of
 ## Examples
 
 ### Request
-The following example shows a request.
+The following example shows a request that lists tags.
 
-# [HTTP](#tab/http)
+# [HTTP](#tab/http) 
 <!-- {
   "blockType": "request",
   "name": "list_ediscoveryreviewtag_and_properties"
 }
 -->
+
 ``` http
 GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/tags
 ```

api-reference/beta/api/security-ediscoveryreviewtag-ashierarchy.md

@@ -46,9 +46,9 @@ Don't supply a request body for this method.
 If successful, this function returns a `200 OK` response code and a [microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection in the response body.
 
 ## Examples
-
-### Request
-The following example shows a request.
+### Example 1: Retrieve child tags of a specific eDiscovery review tag
+#### Request
+The following example shows a request that retrieves child tags.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -94,7 +94,7 @@ GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-ceb
 
 ---
 
-### Response
+#### Response
 The following example shows the response.
 >**Note:** The response object shown here might be shortened for readability.
 <!-- {
@@ -198,3 +198,37 @@ Content-Type: application/json
 }
 ```
 
+### Example 2: Retrieve child tags of a specific eDiscovery review tag
+#### Request
+The following example shows a request to retrieve child tags
+<!-- {
+  "blockType": "request",
+  "name": "ediscoveryreviewtagthis.childtags"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b6f72954-c7d0-414c-ad50-00167216cb03/tags/318f79767abf4b8fab4d8e37b3174c5a/childTags
+```
+
+#### Response
+The following example shows the response.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Collection(microsoft.graph.security.ediscoveryReviewTag)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.security.ediscoveryReviewTag)",
+    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET security/cases/ediscoveryCases('<guid>')/tags('<guid>')/childTags?$select=childSelectability",
+    "value": []
+}
+```
+
+
+

api-reference/v1.0/api/security-ediscoverycase-list-tags.md

@@ -22,7 +22,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 [!INCLUDE [permissions-table](../includes/permissions/security-ediscoverycase-list-tags-permissions.md)]
 
 ## HTTP request
-
 <!-- {
   "blockType": "ignored"
 }
@@ -43,16 +42,15 @@ Don't supply a request body for this method.
 If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.security.ediscoveryreviewtag](../resources/security-ediscoveryreviewtag.md) objects in the response body.
 
 ## Examples
-
 ### Request
 The following example shows a request.
-
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "create_ediscoveryreview_caseID_tag"
 }
 -->
+
 ``` http
 GET https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/58399dff-cebe-478f-b1af-d3227f1fd645/tags
 ```
@@ -93,7 +91,7 @@ GET https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/58399dff-ceb
 
 ### Response
 The following example shows the response.
->**Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability.
 <!-- {
   "blockType": "response",
   "truncated": true,

api-reference/v1.0/api/security-ediscoveryreviewtag-ashierarchy.md

@@ -46,9 +46,9 @@ Don't supply a request body for this method.
 If successful, this function returns a `200 OK` response code and a [microsoft.graph.security.ediscoveryReviewTag](../resources/security-ediscoveryreviewtag.md) collection in the response body.
 
 ## Examples
-
-### Request
-The following example shows a request.
+### Example 1: Retrieve child tags of a specific eDiscovery 
+#### Request
+The following example shows a request that retrieves child tags.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -94,7 +94,7 @@ GET https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/58399dff-ceb
 
 ---
 
-### Response
+#### Response
 The following example shows the response.
 >**Note:** The response object shown here might be shortened for readability.
 <!-- {
@@ -198,3 +198,35 @@ Content-Type: application/json
 }
 ```
 
+### Example 2: Retrieve child tags of a specific eDiscovery review tag
+#### Request
+The following example shows a request that retrieves child tags.
+<!-- {
+  "blockType": "request",
+  "name": "ediscoveryreviewtagthis.childtags"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b6f72954-c7d0-414c-ad50-00167216cb03/tags/318f79767abf4b8fab4d8e37b3174c5a/childTags
+```
+
+#### Response
+The following example shows the response.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Collection(microsoft.graph.security.ediscoveryReviewTag)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.security.ediscoveryReviewTag)",
+    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET security/cases/ediscoveryCases('<guid>')/tags('<guid>')/childTags?$select=childSelectability",
+    "value": []
+}
+```
+