Merge branch 'WI370671-api-fixes-for-docs' of https://github.com/DeCohen/defender-docs-pr into WI370671-api-fixes-for-docs

Author: DeCohen

CloudAppSecurityDocs/api-activities-feedback.md

@@ -32,7 +32,7 @@ POST /api/v1/activities/<pk>/feedback
 
 ### Request
 
-Here is an example of the request.
+Here's an example of the request.
 
 ```rest
 curl -XPOST -H "Authorization:Token <your_token_key>"  -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/activities/<pk>/feedback" -d '{
@@ -49,7 +49,7 @@ Returns a list of activities in JSON format.
 
 ```json
 {
-  "total": 5 // total number of records
+  "total": 5 // approximate number of records
   "hasNext": true // whether there is more data to show or not.
   "data": [
     // returned records

CloudAppSecurityDocs/api-activities-list.md

@@ -24,7 +24,7 @@ POST /api/v1/activities/
 
 | Parameter | Description |
 | --- | --- |
-| filters | Filter objects with all the search filters for the request, see [activity filters](api-activities.md#filters) for more details |
+| filters | Filter objects with all the search filters for the request, for more details see [activity filters](api-activities.md#filters)  |
 | sortDirection | The sorting direction. Possible values are: `asc` and `desc` |
 | sortField | Fields used to sort activities. Possible values are: <li> **date**: The date when then the activity happened <li> **created**: The [timestamp](api-introduction.md#timestamps) when the activity was saved |
 | skip | Skips the specified number of records |
@@ -34,7 +34,7 @@ POST /api/v1/activities/
 
 ### Request
 
-Here is an example of the request.
+Here's an example of the request.
 
 ```rest
 curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/activities/" -d '{
@@ -53,7 +53,7 @@ Returns a list of activities in JSON format.
 
 ```json
 {
-  "total": 5 // total number of records
+  "total": 5 // approximate number of records
   "hasNext": true // whether there is more data to show or not.
   "data": [
     // returned records

CloudAppSecurityDocs/api-data-enrichment-list.md

@@ -24,7 +24,7 @@ POST /api/v1/subnet/
 
 | Parameter | Description |
 | --- | --- |
-| filters | Filter objects with all the search filters for the request, see [IP range filters](api-data-enrichment.md#filters) for more details |
+| filters | Filter objects with all the search filters for the request, for more details see [IP range filters](api-data-enrichment.md#filters)  |
 | sortDirection | The sorting direction. Possible values are: `asc` and `desc` |
 | sortField | Fields used to sort IP ranges. Possible values are:<br />- **category**: The category of the IP range<br />- **tags**: The tags of the IP range<br />- **name**: The name of the IP range |
 | skip | Skips the specified number of records |
@@ -34,7 +34,7 @@ POST /api/v1/subnet/
 
 ### Request
 
-Here is an example of the request.
+Here's an example of the request.
 
 ```rest
 curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/subnet/" -d '{
@@ -53,7 +53,7 @@ Returns a list of IP ranges in JSON format. For information about the response f
 
 ```json
 {
-  "total": 1 // total number of records
+  "total": 1 // approximate number of records
   "hasNext": false // whether there is more data to show or not.
   "data": [
     {

CloudAppSecurityDocs/api-entities-list.md

@@ -27,7 +27,7 @@ POST /api/v1/entities/
 
 | Parameter | Description |
 | --- | --- |
-| filters | Filter objects with all the search filters for the request, see [entity filters](api-entities.md#filters) for more details |
+| filters | Filter objects with all the search filters for the request, for more details see [entity filters](api-entities.md#filters)  |
 | sortDirection | The sorting direction. Possible values are: `asc` and `desc` |
 | sortField | Fields used to sort entities. Possible values are:<br />- **date**: The date when then the entity was created<br />- **severity**: The severity of the entity |
 | skip | Skips the specified number of records |
@@ -37,7 +37,7 @@ POST /api/v1/entities/
 
 ### Request
 
-Here is an example of the request.
+Here's an example of the request.
 
 ```rest
 curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/entities/" -d '{
@@ -56,7 +56,7 @@ Returns a list of activities in JSON format.
 
 ```json
 {
-  "total": 5 // total number of records
+  "total": 5 // approximate number of records
   "hasNext": true // whether there is more data to show or not.
   "data": [
     // returned records

CloudAppSecurityDocs/api-files-list.md

@@ -11,7 +11,7 @@ ms.topic: reference
 > [!NOTE]
 >
 > - This API is not available for Microsoft 365 Cloud App Security.
-> - This endpoint may time out when filtering and paginating large collections.
+> - This endpoint might time out when filtering and paginating large collections.
 
 Run the GET or POST request to fetch a list of files matching the specified filters.
 
@@ -29,15 +29,15 @@ POST /api/v1/files/
 
 | Parameter | Description |
 | --- | --- |
-| filters | Filter objects with all the search filters for the request, see [file filters](api-files.md#filters) for more details |
+| filters | Filter objects with all the search filters for the request, for more details see [file filters](api-files.md#filters)  |
 | skip | Skips the specified number of records |
 | limit | Maximum number of records returned by the request |
 
 ## Example
 
 ### Request
 
-Here is an example of the request.
+Here's an example of the request.
 
 ```rest
 curl -XPOST -H "Authorization:Token <your_token_key>" -H "Content-Type: application/json" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/v1/files/" -d '{
@@ -56,7 +56,7 @@ Returns a list of files in JSON format.
 
 ```json
 {
-  "total": 5 // total number of records
+  "total": 5 // approximate number of records
   "hasNext": true // whether there is more data to show or not.
   "data": [
     // returned records