Alerts API
This applies to: Visual Data Discovery
Alerts allow you to alert your end users when a metric reaches a specified threshold. Symphony API endpoints can be used to create, update, and delete alert definitions, each describing an alert condition, the schedule by which it is evaluated, and how notification is handled when the alert condition is met.
API support for alerting is performed using the REST API endpoint /api/alerts
, as described below.
Endpoint | Method | Description |
---|---|---|
/api/alerts/{id}
|
GET | Returns a specific alert definition, identified by its ID. In a multi tenancy environment, respects Recipients rules. |
/api/alerts/{id}
|
PUT | Updates a specific alert definition, identified by its ID. Completely replaces the previous version of the alert definition. |
/api/alerts/{id}
|
DELETE | Deletes a specific alert definition, identified by its ID. |
/api/alerts/{id}
|
PATCH | Patches a specific alert definition, identified by its ID. |
/api/alerts
|
GET | Returns all alert definitions. |
/api/alerts
|
POST | Creates a new alert. This endpoint requires the ROLE_CREATE_ALERT privilege. |
/api/alerts/{id}/evaluate-condition
|
POST | Evaluates an alert condition in a specific alert definition. |
API documentation is provided with your Symphony installation at this link: <symphony-URL>/discovery/swagger-ui.html
.