# ThousandEyes Alerts API

**Canonical:** https://apis.io/apis/thousandeyes/thousandeyes-alerts-api/  
**Provider:** ThousandEyes — https://apis.io/providers/thousandeyes/  
**Base URL:** https://api.thousandeyes.com/v7  
**Documentation:** https://developer.cisco.com/docs/thousandeyes/alerts-api-overview/

ThousandEyes Alerts API is one of 26 APIs that [ThousandEyes](https://apis.io/providers/thousandeyes/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Alerts, Alert Rules, and Alert Suppression Windows. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

You can manage the following alert functionalities on the ThousandEyes platform using the Alerts API: * **Alerts**: Retrieve alert details. Alerts are assigned to tests through alert rules. * **Alert Rules**: Conditions that you configure in order to highlight or be notified of events of interest in your ThousandEyes tests. When an alert rule’s conditions are met, the associated alert is triggered and the alert becomes active. It remains active until the alert is cleared. Alert rules are reusable across multiple tests.. * **Alert Suppression Windows**: Suppress alerts for tests during periods such as planned maintenance. Windows can be one-time events or recurring events to handle periodic occurrences such as monthly downtime for maintenance. For more information about the alerts, see Alerts.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/thousandeyes/refs/heads/main/openapi/thousandeyes-alerts-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/thousandeyes/refs/heads/main/overlays/thousandeyes-alerts-overlay.yaml
- **APIReference** — https://developer.cisco.com/docs/thousandeyes/alerts-api-overview/

## Other ThousandEyes APIs (12)

- [ThousandEyes Administrative API](https://apis.io/apis/thousandeyes/thousandeyes-administrative-api/)
- [ThousandEyes API Token Management API](https://apis.io/apis/thousandeyes/thousandeyes-api-token-management-api/)
- [ThousandEyes Agents API](https://apis.io/apis/thousandeyes/thousandeyes-agents-api/)
- [ThousandEyes Autonomous Systems API](https://apis.io/apis/thousandeyes/thousandeyes-autonomous-systems-api/)
- [ThousandEyes BGP Monitors API](https://apis.io/apis/thousandeyes/thousandeyes-bgp-monitors-api/)
- [ThousandEyes Cloud Insights Integrations API](https://apis.io/apis/thousandeyes/thousandeyes-cloud-insights-integrations-api/)
- [ThousandEyes Credentials API](https://apis.io/apis/thousandeyes/thousandeyes-credentials-api/)
- [ThousandEyes Dashboards API](https://apis.io/apis/thousandeyes/thousandeyes-dashboards-api/)
- [ThousandEyes Emulation API](https://apis.io/apis/thousandeyes/thousandeyes-emulation-api/)
- [ThousandEyes Endpoint Agents API](https://apis.io/apis/thousandeyes/thousandeyes-endpoint-agents-api/)
- [ThousandEyes Endpoint Instant Scheduled Tests API](https://apis.io/apis/thousandeyes/thousandeyes-endpoint-instant-scheduled-tests-api/)
- [ThousandEyes Endpoint Agent Labels API](https://apis.io/apis/thousandeyes/thousandeyes-endpoint-agent-labels-api/)

## Tags

Alerts, Alert Rules, Alert Suppression Windows

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/thousandeyes/thousandeyes-alerts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/thousandeyes/.