# Incident.io Alerts V2 API

**Canonical:** https://apis.io/apis/incident-io/incident-io-alerts-v2-api/  
**Provider:** Incident.io — https://apis.io/providers/incident-io/  
**Base URL:** https://api.incident.io  
**Documentation:** https://incident.io

Incident.io Alerts V2 API is one of 92 APIs that [Incident.io](https://apis.io/providers/incident-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Alerts V2. The published artifact set on APIs.io includes an OpenAPI specification.

Read your alerts in incident.io. Alerts are events ingested from third parties by alert sources. They can trigger incidents and escalations, as configured in alert routes. To view your alerts, you can list all alerts, or show a single alert. If you'd like to view only alerts that are currently firing, you can filter by status. To view the alert that was created for an event in your external system, filter by deduplication key. If you'd like to view alerts connected to a particular incident, you can list incident alerts. You can filter by incident_id to find all alerts attached to a particular incident, or by alert_id to find the incident that a particular alert triggered.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/alert_tags` | ListAlertTags Alerts V2 |
| GET | `/v2/alerts` | List Alerts V2 |
| GET | `/v2/alerts/{id}` | Show Alerts V2 |
| POST | `/v2/alerts/{id}/actions/add_tags` | AddTags Alerts V2 |
| POST | `/v2/alerts/{id}/actions/remove_tags` | RemoveTags Alerts V2 |
| POST | `/v2/alerts/{id}/actions/resolve` | Resolve Alerts V2 |
| POST | `/v2/alerts/{id}/actions/set_tags` | SetTags Alerts V2 |
| GET | `/v2/incident_alerts` | ListIncidentAlerts Alerts V2 |
| POST | `/v2/incident_alerts` | CreateIncidentAlert Alerts V2 |
| POST | `/v2/incident_alerts/{id}/actions/transition` | TransitionIncidentAlert Alerts V2 |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/incident-io/refs/heads/main/openapi/incident-io-alerts-v2-api-openapi.yml

## Other Incident.io APIs (12)

- [Incident.io Actions API](https://apis.io/apis/incident-io/incident-io-actions-api/)
- [Incident.io Alert Attributes API](https://apis.io/apis/incident-io/incident-io-alert-attributes-api/)
- [Incident.io Alert Routes API](https://apis.io/apis/incident-io/incident-io-alert-routes-api/)
- [Incident.io Alert Sources API](https://apis.io/apis/incident-io/incident-io-alert-sources-api/)
- [Incident.io Alerts API](https://apis.io/apis/incident-io/incident-io-alerts-api/)
- [Incident.io API Keys API](https://apis.io/apis/incident-io/incident-io-api-keys-api/)
- [Incident.io Catalog Entries API](https://apis.io/apis/incident-io/incident-io-catalog-entries-api/)
- [Incident.io Catalog Types API](https://apis.io/apis/incident-io/incident-io-catalog-types-api/)
- [Incident.io Custom Fields API](https://apis.io/apis/incident-io/incident-io-custom-fields-api/)
- [Incident.io Escalation Paths API](https://apis.io/apis/incident-io/incident-io-escalation-paths-api/)
- [Incident.io Escalations API](https://apis.io/apis/incident-io/incident-io-escalations-api/)
- [Incident.io Follow-ups API](https://apis.io/apis/incident-io/incident-io-follow-ups-api/)

## Tags

Alerts V2

---

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