Document toolboxDocument toolbox

Alerting API

The Devo Alerting API can be used to work with alerts easily, without the need of logging in to your Devo domain. You can use it to create new alerts, check their statuses, update them, or get information about them. To learn more about alerts in Devo, go to Alerting API.

To perform a request with the Devo Alerting API, choose the endpoint based on your Devo domain's region:

Add the corresponding path to your endpoint to perform the operation you need, such as creating a new alert, modifying it, or deleting it. Check all the available operations and how to perform them in the following section.

Authorizing Alerting API requests

You must add the following headers to authorize your requests:

Header

Value

Header

Value

Content-Type

Enter application/json

standAloneToken

You need to enter a valid token to authorize your request. You can generate this token in the Administration → Credentials → Authentication Tokens area of Devo. Click Create new token and choose Query data using REST API. Give your token a name, enter the target data tables you want to work with, and click Accept to generate it.

The generated token will appear in the same area, in the table below. Learn more about tokens in Devo in Alerting API.

Alerting API and web interaction

Alerts defined through the Alerting API will appear in your Devo domain just like alerts defined in the application, under Administration → Alert Configuration → Available Alerts. However, you must take into account the following considerations:

  • You will be able to view, start, stop, and delete alerts defined through the Alerting API in the Devo application.

  • However, alerts created through the Alerting API cannot be modified in your Devo domain.

  • The Go to query option that appears in the details of the alerts created through the web app will not be available in alerts defined using the Alerting API.

  • Also, note that alerts with subqueries can only be created through the Alerting API, not in the Devo app. However, they will appear in the Administration → Alert Configuration area, and you can check their details.