How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ThousandEyes Alert Rules API

The Alert Rules API from ThousandEyes — 2 operation(s) for alert rules.

ThousandEyes Alert Rules API is one of 98 APIs that ThousandEyes publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Alert Rules. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 5 operations across 2 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 7.0.100.

Requests are made against a single base URL, https://api.thousandeyes.com/v7.

5 operations 2 paths 36 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
7.0.100
Base URL
https://api.thousandeyes.com/v7
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

ThousandEyes Alert Rules API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Bearer authentication token

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Alert Rules 5
GET
/alerts/rules
List alert rules
getAlertsRules 1 param → 200401403404429500
POST
/alerts/rules
Create alert rule
createAlertRule 1 param body → 201400401403404429500
GET
/alerts/rules/{ruleId}
Retrieve alert rule
getAlertRule 2 params → 200401403404429500
PUT
/alerts/rules/{ruleId}
Update alert rule
updateAlertRule 2 params body → 200400401403404429500
DELETE
/alerts/rules/{ruleId}
Delete alert rule
deleteAlertRule 2 params → 204400401403404429500

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are BaseRule (20 properties), AlertSimpleTest (14 properties), Link (8 properties), Error (5 properties). Each schema is shown below with its type and property counts.

ValidationError
object
WebhookIntegrationType
string
Integration type.
AlertSimpleTest
object
Each test includes additional fields depending on its type. Refer /tests/{type} endpoint to know the set of fields returned by a given type.
14 properties
Severity
string
The severity of the alert.
Rule
Rules
object
2 properties
TestCreatedDate
string
UTC created date (ISO date-time format).
TestCreatedBy
string
User that created the test.
ValidationErrorItem
object
3 properties
TestLinks
object
A list of links that can be accessed to get more information
2 properties
AlertType
string
Type of alert being triggered. In multi-layered tests, this value represents the layer the alert relates to. See [Alert Details](https://developer.cisco.com/do…
AlertNotification
object
Alert notification object. See Alert notification integrations.
4 properties
SensitivityLevel
string
Used when roundsViolatingMode is set to auto. The default is medium. Higher sensitivity increases the likelihood of triggering alerts.
RuleId
string
Unique ID of the rule.
BaseRule
object
20 properties 4 required
AlertRoundsViolationMode
string
exact requires the same agents to meet the threshold in consecutive rounds. auto is only enabled for CEA and Endpoint Scheduled test rules. The default is any.
CustomWebhookIntegrationType
string
Integration type.
Enabled
boolean
Test is enabled.
ThirdPartyIntegrationType
string
Integration type.
RuleDetail
UnauthorizedError
object
2 properties
Link
object
A hyperlink from the containing resource to a URI.
8 properties 1 required
AlertGroupType
string
Category of alert type based on the application or network layer and source of the test.
TestResults
array
Reference to the test results.
RuleTestIds
array
Array of test IDs to link to alert rule (get testId from /tests endpoint).
TestInterval
integer
Interval between test runs in seconds.
RuleDetailUpdate
Error
object
5 properties
NotificationEmail
object
Email notifications.
2 properties
NotificationThirdParty
object
Webhook notification.
2 properties
AlertTestType
string
Valid Alert Types for which to return test links.
TestSelfLink
NotificationWebhook
object
Webhook notification.
4 properties
SelfLinks
object
A links object containing the self link.
1 property
AlertDirection
string
Direction for applicable alert types (eg. path trace, End-to-End (Agent) etc.)
NotificationCustomWebhook
object
Custom webhook notification.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thousandeyes-alert-rules-api-openapi.yml Raw ↑

Other APIs ThousandEyes publishes across the network.

ThousandEyes Account Groups API
ThousandEyes Agent Proxies API
ThousandEyes Agent to Agent Instant Tests API
ThousandEyes Agent to Agent Tests API
ThousandEyes Agent To Server Endpoint Dynamic Tests API
ThousandEyes Agent to Server Endpoint Instant Scheduled Tests API
ThousandEyes Agent to Server Endpoint Scheduled Tests API
ThousandEyes Agent to Server Instant Tests API
ThousandEyes Agent to Server Tests API
ThousandEyes Alert Suppression Windows API
ThousandEyes Alerts API
ThousandEyes API Instant Tests API
Where this information came from

This is an independent, third-party profile of ThousandEyes Alert Rules API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.