# Uptimely Alerts API

**Canonical:** https://apis.io/apis/getuptimely-com/getuptimely-com-alerts-api/  
**Provider:** Uptimely — https://apis.io/providers/getuptimely-com/  
**Base URL:** https://app.getuptimely.com  
**Documentation:** https://getuptimely.com/docs/api-reference

Uptimely Alerts API is one of 8 APIs that [Uptimely](https://apis.io/providers/getuptimely-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include Alerts. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

Alerts — monitor-level events with lifecycle states; creating one drives episode grouping and on-call.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/alerts` | List alerts |
| POST | `/v1/alerts` | Create an alert |
| POST | `/v1/alerts/{alert_id}/state-changes` | Change an alert's state |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/getuptimely-com/openapi/getuptimely-com-alerts-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/getuptimely-com/json-schema/getuptimely-com-alert-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/getuptimely-com/json-schema/getuptimely-com-state-change-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/getuptimely-com/json-schema/getuptimely-com-alert-created-schema.json
- **APIsJSON** — https://artifacts.apis.io/getuptimely-com/apis.yml

## Other Uptimely APIs (7)

- [Uptimely Incidents API](https://apis.io/apis/getuptimely-com/getuptimely-com-incidents-api/)
- [Uptimely Monitors API](https://apis.io/apis/getuptimely-com/getuptimely-com-monitors-api/)
- [Uptimely On Call API](https://apis.io/apis/getuptimely-com/getuptimely-com-on-call-api/)
- [Uptimely Scheduled Maintenances API](https://apis.io/apis/getuptimely-com/getuptimely-com-scheduled-maintenances-api/)
- [Uptimely Status Pages API](https://apis.io/apis/getuptimely-com/getuptimely-com-status-pages-api/)
- [Uptimely Usage API](https://apis.io/apis/getuptimely-com/getuptimely-com-usage-api/)
- [Uptimely Webhooks API](https://apis.io/apis/getuptimely-com/getuptimely-com-webhooks-api/)

## Tags

Alerts

---

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