more sanity

Author: batamig

articles/defender-for-iot/organizations/api/management-alert-apis.md

@@ -137,13 +137,13 @@ For more information, see [Sensor API version reference](../references-work-with
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<>IP_ADDRESS>/external/v1/alerts?state=&zoneId=&fromTime=&toTime=&siteId=&sensor='
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://127.0.0.1/external/v1/alerts?state=unhandled&zoneId=1&fromTime=0&toTime=1594551777000&siteId=1&sensor=1'
 ```
 
@@ -214,15 +214,15 @@ Array of JSON objects that represent devices.
 
 
 
-### Response example Successful
+### Response example: Successful
 
 ```rest
 {
     "content": "Alert update request finished successfully"
 }
 ```
 
-### Response example Unsuccessful
+### Response example: Unsuccessful
 
 ```rest
 {
@@ -236,13 +236,13 @@ Array of JSON objects that represent devices.
 
 **APIs**:
 
-```curl
+```rest
 curl -k -X PUT -d '{"action": "<ACTION>"}' -H "Authorization: <AUTH_TOKEN>" https://<IP_ADDRESS>/external/v1/alerts/<UUID>
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -X PUT -d '{"action": "handle"}' -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" https://127.0.0.1/external/v1/alerts/1-1594550943000
 ```
 ---
@@ -296,13 +296,13 @@ Creates a new maintenance window.
 
 **API**:
 
-```curl
+```rest
 curl -k -X POST -d '{"ticketId": "<TICKET_ID>",ttl": <TIME_TO_LIVE>,"engines": [<ENGINE1, ENGINE2...ENGINEn>],"sensorIds": [<SENSOR_ID1, SENSOR_ID2...SENSOR_IDn>],"subnets": [<SUBNET1, SUBNET2....SUBNETn>]}' -H "Authorization: <AUTH_TOKEN>" https://<IP address>/external/v1/maintenanceWindow
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -X POST -d '{"ticketId": "a5fe99c-d914-4bda-9332-307384fe40bf","ttl": "20","engines": ["ANOMALY"],"sensorIds": ["5","3"],"subnets": ["10.0.0.0/16"]}' -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" https://127.0.0.1/external/v1/maintenanceWindow
 ```
 ---
@@ -337,13 +337,13 @@ Closes an existing maintenance window.
 
 **API**:
 
-```curl
+```rest
 curl -k -X DELETE -d '{"ticketId": "<TICKET_ID>"}' -H "Authorization: <AUTH_TOKEN>" https://<IP address>/external/v1/maintenanceWindow
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -X DELETE -d '{"ticketId": "a5fe99c-d914-4bda-9332-307384fe40bf"}' -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" https://127.0.0.1/external/v1/maintenanceWindow
 ```
 
@@ -400,13 +400,13 @@ Array of JSON objects that represent maintenance window operations.
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<IP_ADDRESS>/external/v1/maintenanceWindow?fromDate=&toDate=&ticketId=&tokenName='
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://127.0.0.1/external/v1/maintenanceWindow?fromDate=2020-01-01&toDate=2020-07-14&ticketId=a5fe99c-d914-4bda-9332-307384fe40bf&tokenName=a'
 ```
 
@@ -446,13 +446,13 @@ This method is useful when you want to set a longer duration than the currently
 
 **API**:
 
-```curl
+```rest
 curl -k -X PUT -d '{"ticketId": "<TICKET_ID>",ttl": "<TIME_TO_LIVE>"}' -H "Authorization: <AUTH_TOKEN>" https://<IP address>/external/v1/maintenanceWindow
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -X PUT -d '{"ticketId": "a5fe99c-d914-4bda-9332-307384fe40bf","ttl": "20"}' -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" https://127.0.0.1/external/v1/maintenanceWindow
 ```
 ---
@@ -525,15 +525,16 @@ Message string with the operation status details:
 
 **APIs**
 
-```curl
+```rest
 curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<IP_ADDRESS>/external/v2/alerts/pcap/<ID>'
 ```
 
 ***Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://10.1.0.1/external/v2/alerts/pcap/1'
 ```
+---
 
 ## Next steps
 

articles/defender-for-iot/organizations/api/management-appliances-apis.md

@@ -107,13 +107,13 @@ A JSON array of appliance objects that represent sensor appliances.
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<>IP_ADDRESS>/external/v1/appliances'
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://127.0.0.1/external/v1/appliances'
 ```
 ---

articles/defender-for-iot/organizations/api/management-auth-apis.md

@@ -76,13 +76,13 @@ response:
 
 **API**:
 
-```curl
+```rest
 curl -k -d '{"username": "<USER_NAME>","password": "<CURRENT_PASSWORD>","new_password": "<NEW_PASSWORD>"}' -H 'Content-Type: application/json'  https://<IP_ADDRESS>/external/authentication/set_password
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -d '{"username": "myUser","password": "1234@abcd","new_password": "abcd@1234"}' -H 'Content-Type: application/json'  https://127.0.0.1/external/authentication/set_password
 ```
 ---
@@ -167,13 +167,13 @@ response:
 
 **API**:
 
-```curl
+```rest
 curl -k -d '{"admin_username":"<ADMIN_USERNAME>","admin_password":"<ADMIN_PASSWORD>","username": "<USER_NAME>","new_password": "<NEW_PASSWORD>"}' -H 'Content-Type: application/json'  https://<IP_ADDRESS>/external/authentication/set_password_by_admin
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -d '{"admin_user":"adminUser","admin_password": "1234@abcd","username": "myUser","new_password": "abcd@1234"}' -H 'Content-Type: application/json'  https://127.0.0.1/external/authentication/set_password_by_admin
 ```
 ---
@@ -242,13 +242,13 @@ response:
 
 **API**:
 
-```curl
+```rest
 curl -k -X POST -H "Authorization: <AUTH_TOKEN>" -H "Content-Type: application/json" -d '{"username": <USER NAME>, "password": <PASSWORD>}' https://<IP_ADDRESS>/external/authentication/validation
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -X POST -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" -H "Content-Type: application/json" -d '{"username": "test", "password": "test"}' https://127.0.0.1/external/authentication/validation
 ```
 ---

articles/defender-for-iot/organizations/api/management-integration-apis.md

@@ -146,20 +146,20 @@ This API returns data about all devices that were updated after the given timest
 }
 ```
 
-# [cURL](#tab/devices-curl)
+# [cURL command](#tab/devices-curl)
 
 
 **Type**: GET
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/devices/<Timestamp>"
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/devices/<Timestamp>"
 ```
 
@@ -241,19 +241,19 @@ This API returns data about all device connections that were updated after the g
     },
 ```
 
-# [cURL](#tab/connections-curl)
+# [cURL command](#tab/connections-curl)
 
 **Type**: GET
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/connections/1664781014000"
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/connections/1664781014000"
 ```
 
@@ -403,19 +403,19 @@ This API returns data about a specific device per a given device ID.
 }]
 ```
 
-# [cURL](#tab/device-curl)
+# [cURL command](#tab/device-curl)
 
 **Type**: GET
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/device/<device ID>"
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/device/1"
 ```
 
@@ -463,19 +463,19 @@ This API returns a list of IDs of recently deleted devices, from the supplied ti
 }]
 ```
 
-# [cURL](#tab/deleteddevices-curl)
+# [cURL command](#tab/deleteddevices-curl)
 
 **Type**: GET
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/deleteddevices/<timestamp>"
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/deleteddevices/1664781014000"
 ```
 
@@ -508,7 +508,7 @@ An array of the following fields:
 |**u_id** | Long integer | Not nullable | Defines the internal sensor ID, to be used in the [devices (Create and update devices)](#devices-create-and-update-devices) API.|
 | **u_name** | String | Not nullable | Defines the sensor appliance's name. |
 | **u_interface_address** | String | Not nullable | Defines the sensor appliance's network address.|
-|**u_connection_state** |String |Not nullable | Defines the device's connection state with an on-premises management console, using one of the following values: <br><br>- **SYNCED**: Connection is successful. <br>- **OUT_OF_SYNC**: On-premises management console cannot process data received from the sensor. <br>- **TIME_DIFF_OFFSET**: Time drift detected. On-premises management console has been disconnected from the sensor. <br>**DISCONNECTED**: Sensor not communicating with management console. Check network connectivity. |
+|**u_connection_state** |String |Not nullable | Defines the device's connection state with an on-premises management console, using one of the following values: <br><br>- **SYNCED**: Connection is successful. <br>- `OUT_OF_SYNC`: On-premises management console cannot process data received from the sensor. <br>- `TIME_DIFF_OFFSET`: Time drift detected. On-premises management console has been disconnected from the sensor. <br>`DISCONNECTED`: Sensor not communicating with management console. Check network connectivity. |
 |**u_version** | String | Not nullable | A string representation of the sensor's software version. |
 | **u_alert_count** | Long integer | Not nullable | The current number of alerts triggered by the sensor. |
 | **u_device_count** | Long integer | Not nullable | The current number of devices detected by the sensor. |
@@ -518,7 +518,7 @@ An array of the following fields:
 | **u_uid** |String | Not nullable | Defines the sensor's globally unique identifier. |
 | **u_zone_id** | Long integer | Nullable | Define's the device's zone. |
 | **u_is_in_learning_mode** | Boolean | Not nullable  | Determines whether the sensor is in learning mode. |
-| **u_remote_upgrade_stage** | String |Nullable |Defines a current stage in a version update process as one of the following: <br> - **UPLOADING** <br>-  **PREPARE_TO_INSTALL** <br>- **STOPPING_PROCESSES** <br>- **BACKING_UP_DATA** <br>- **TAKING_SNAPSHOT** <br>- **UPDATING_CONFIGURATION** <br>- **UPDATING_DEPENDENCIES** <br>- **UPDATING_LIBRARIES** <br>- **PATCHING_DATABASES** <br>- **STARTING_PROCESSES** <br>- **VALIDATING_SYSTEM_SANITY** <br>- **VALIDATION_SUCCEEDED_REBOOTING** <br>- **SUCCESS** <br>- **FAILURE** <br>- **UPGRADE_STARTED** <br>- **STARTING_INSTALLATION** <br>- **INSTALLING_OPERATING_SYSTEM**|
+| **u_remote_upgrade_stage** | String |Nullable |Defines a current stage in a version update process as one of the following: <br> - `UPLOADING` <br>-  `PREPARE_TO_INSTALL` <br>- `STOPPING_PROCESSES` <br>- `BACKING_UP_DATA` <br>- `TAKING_SNAPSHOT` <br>- `UPDATING_CONFIGURATION` <br>- `UPDATING_DEPENDENCIES` <br>- `UPDATING_LIBRARIES` <br>- `PATCHING_DATABASES` <br>- `STARTING_PROCESSES` <br>- `VALIDATING_SYSTEM_SANITY` <br>- `VALIDATION_SUCCEEDED_REBOOTING` <br>- `SUCCESS` <br>- `FAILURE` <br>- `UPGRADE_STARTED` <br>- `STARTING_INSTALLATION` <br>- `INSTALLING_OPERATING_SYSTEM`|
 
 #### Response example
 
@@ -543,19 +543,19 @@ An array of the following fields:
 ];
 ```
 
-# [cURL](#tab/sensors-curl)
+# [cURL command](#tab/sensors-curl)
 
 **Type**: GET
 
 **API**:
 
-```curl
+```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP Address>/external/v3/integration/sensors"
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/sensors"
 ```
 
@@ -614,9 +614,9 @@ This API returns a list of active CVEs for all devices that were updated since t
 |**u_cves** | JSON array of CVEs | Not nullable | An array of [CVE details](#u_cves-fields) objects |
 
 > [!NOTE]
-> If Defender for IoT can confidently identify the MAC address of one of its IP addresses, the MAC address is returned in the **u_mac_address_objects** field directly.
+> If Defender for IoT can confidently identify the MAC address of one of its IP addresses, the MAC address is returned in the `u_mac_address_objects` field directly.
 >
-> If Defender for IoT is not entirely confident about a MAC address, such as if the traffic has been routed via a router, the MAC address is returned in the **u_guessed_mac_address** field instead, as part of the JSON array of IP addresses.
+> If Defender for IoT is not entirely confident about a MAC address, such as if the traffic has been routed via a router, the MAC address is returned in the `u_guessed_mac_address` field instead, as part of the JSON array of IP addresses.
 
 #### u_ip_address_objects fields
 
@@ -638,7 +638,7 @@ This API returns a list of active CVEs for all devices that were updated since t
 |**u_address** |String | Not nullable | Address of the specific interface, with the specific firmware where the CVE was detected. |
 | **u_cve_id**| String| Not nullable | Defines the CVE ID |
 |**u_score** | String| Not nullable | Defines the CVE risk score |
-| **u_attack_vector**|String | Not nullable | Defines the attack vector as one of the following: **ADJACENT_NETWORK**, **LOCAL**, **NETWORK** |
+| **u_attack_vector**|String | Not nullable | Defines the attack vector as one of the following: `ADJACENT_NETWORK`, `LOCAL`, `NETWORK` |
 | **u_description**| String| Not nullable | Defines the CVE description|
 
 #### Response example
@@ -717,11 +717,21 @@ This API returns a list of active CVEs for all devices that were updated since t
 }
 ```
 
-# [cURL](#tab/devicecves-curl)
+# [cURL command](#tab/devicecves-curl)
+
+**Type**: GET
+
+**API**:
 
 ```rest
 curl -k -H "Authorization: <Authorization token>" "https://<IP Address>/external/v3/integration/devicecves/<timestamp>"
 ```
+
+**Examplle**:
+
+```rest
+curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/devicecves/1664781014000"
+```
 ---
 
 ## Next steps

articles/defender-for-iot/organizations/api/management-inventory-apis.md

@@ -225,13 +225,13 @@ Array of JSON objects that represent devices.
 
 **APIs**:
 
-```curl
+```rest
 curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<IP_ADDRESS>/external/v1/devices?siteId=&zoneId=&sensorId=&uthorized='
 ```
 
 **Example**:
 
-```curl
+```rest
 curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://127.0.0.1/external/v1/devices?siteId=1&zoneId=2&sensorId=5&authorized=true'
 ```