dots.v2.insights.alertRules.get()
Generated on 13 Nov 2026
from DoTs version
v1.24.0
Usage
client.v2.insights.alertRules.get(requestConfiguration?: RequestConfiguration<AlertRulesRequestBuilderGetQueryParameters>): Promise<undefined | AlertRulesGetResponse>Description
To list alert rules for your account, send a GET request to
/v2/insights/alert-rules. Results are paginated with page and per_page
(default 20, maximum 200). Optionally filter by resource_urn.
Parameters
pageinteger optionalExample:
1Which 'page' of paginated results to return.
perPageinteger optionalExample:
2Number of items returned per page
resourceUrnstring optionalExample:
do:droplet:12345Optional filter. When set, only resources associated with this resource URN
are returned.
Request Sample
Pagination
This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page query parameter:
let response = await client.v2.insights.alertRules.get();
let pages = response?.links?.pages;
while (pages && "next" in pages && typeof pages.next === "string") {
const page = Number(new URL(pages.next).searchParams.get("page"));
response = await client.v2.insights.alertRules.get({
queryParameters: {
page,
},
});
pages = response?.links?.pages;
}Response Example
More Information
See /v2/insights/alert-rules in the API reference for additional detail on responses, headers, parameters, and more.