Alert Interface
List configured alerts
GET/api/v6.1.0.26/hubs/{hub}/alerts
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body (JSON) | Prototype:
|
| Status codes | ✅ 200 OK ❌ 400 Bad Request ❌ 404 Not Found: Hub not found |
| Required permissions | ReadOnly access level on hub |
Create alert configuration
POST/api/v6.1.0.26/hubs/{hub}/alerts
| Query parameters | None |
| Request headers | Prototype:
|
| Request body (JSON) | Prototype:
|
| Response headers | None |
| Response body | None |
| Status codes | ✅ 201 Created ❌ 400 Bad Request: Alert already exists ❌ 404 Not Found: Hub not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Create
|
Delete alert configuration
DELETE/api/v6.1.0.26/hubs/{hub}/alerts/{alert}
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Delete
|
Clear alert state
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/clear
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Clear
|
Disable an alert configuration
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/disable
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Disable
|
Execute alert configuration now
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/execute
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body (text) | None |
| Status codes | ✅ 200 OK ❌ 400 Bad Request ❌ 404 Not Found: Hub not found |
| Required permissions | ReadExec access level on hub |
| Events | Creates the following event: Alert_Notification
|
Get alert configuration properties
GET/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/props
| Query parameters | Prototype:
|
| Request headers | Prototype:
|
| Request body | None |
| Response headers | Prototype:
|
| Response body (JSON) | Prototype:
|
| Status codes | ✅ 200 OK ❌ 400 Bad Request: Specified property does not exist ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadOnly access level on hub |
Set/reset alert configuration properties
PATCH/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/props
| Query parameters | None |
| Request headers | Prototype:
|
| Request body (JSON) | Prototype:
|
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Property_Change
|
Replace all alert configuration properties
PUT/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/props
| Query parameters | None |
| Request headers | Prototype:
|
| Request body (JSON) | Prototype:
|
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Property_Set
|
Delete alert configuration properties
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/props_delete
| Query parameters | None |
| Request headers | None |
| Request body (JSON) | Prototype:
|
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Property_Delete
|
Modify alert configuration properties
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/props_modify
| Query parameters | None |
| Request headers | Prototype:
|
| Request body (JSON) | Prototype:
|
| Response headers | None |
| Response body | None |
| Status codes | ✅ 204 No Content ❌ 400 Bad Request ❌ 404 Not Found: Hub or Alert not found |
| Required permissions | ReadWrite access level on hub |
| Events | Creates the following event: Alert_Property_Change
|
Send test alert notifications
POST/api/v6.1.0.26/hubs/{hub}/alerts/{alert}/test
| Query parameters | None |
| Request headers | None |
| Request body | None |
| Response headers | None |
| Response body (text) | None |
| Status codes | ✅ 200 OK ❌ 400 Bad Request ❌ 404 Not Found: Hub not found |
| Required permissions | ReadExec access level on hub |
| Events | Creates no events. |