List all Alerts

get

https://api.controlup.com/edge/api/alerts

Returns a list of configured alerts.

You can either:

Use query to use an OpenSearch query. Note that you can't create an OpenSearch query using the request builder built into the documentation.
Use the remaining query parameters to query alerts.

Required permissions - View, Create, Edit and Delete Alerts

Query Params

query

object

An OpenSearch query.

size

integer

≤ 10000

Defaults to 10000

The number of rows returned per page.

page

integer

Defaults to 1

The page returned. The number of rows per page is set with the size parameter.

from

integer

The index of the rows array to start returning data from. The array index starts at 0. For example, if you set from = 2, the first two rows are excluded.

filters[0][field]

string

Filters the returned data based on the specified field name. This parameter must be used in combination with filters[0][type] and filters[0][value] to define a filter condition.
You can add multiple filter conditions by changing the integer in the parameter names (for example, filters[1][field]).

filters[0][type]

string

enum

The type of filter used in corresponding filter condition. The type of filter you can use depends on the data type of the field.

<, <=, =, !=, <=, or > are used to filter numbers and dates.

boolean is used to filter boolean fields.

like is used to filter text fields.

filters[0][value]

The value used in the corresponding filter condition. The value you can use depends on the filter type.

If you are filtering a date or text field, enter a string. If you are filtering a number field, enter a number. If you are filtering a boolean field, enter a boolean. If you are filtering a text field, you can use * as a wildcard, or begin the string with !! to exclude items that contain the string.

sorters[0][field]

string

Sorts the returned data based on the specified field name. This parameter must be used in combination with sorters[0][dir] to set the sort order.
You can sort by more than one field by changing the integer in the parameter names (for example, sorters[1][field]). Sorters with a lower integer are applied first.

sorters[0][dir]

string

enum

The sort order for the corresponding field. Set to asc for ascending, or desc for descending.

Allowed:

Responses

400

The provided query is invalid.

401

Invalid or missing API key.

403

API key is expired.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200List of configured alerts.