# Grafana Annotations API

**Canonical:** https://apis.io/apis/grafana-com/grafana-annotations-api/  
**Provider:** Grafana — https://apis.io/providers/grafana-com/  
**Documentation:** https://grafana.com/docs/grafana/latest/developers/http_api/annotations/

Grafana Annotations API is one of 20 APIs that [Grafana](https://apis.io/providers/grafana-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Observability, Grafana, and Annotations. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

Create, read, update, and delete annotations on Grafana dashboards. Annotations mark events (deploys, incidents, releases) on time-series panels and can be scoped to a dashboard, panel, or organization, and tagged for filtering.

## Machine-readable artifacts (2)

- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/annotations/
- **OpenAPI** — https://github.com/grafana/grafana/blob/main/public/api-merged.json

## Other Grafana APIs (12)

- [Grafana HTTP API](https://apis.io/apis/grafana-com/grafana-http-api/)
- [Grafana Dashboard API](https://apis.io/apis/grafana-com/grafana-dashboard-api/)
- [Grafana Folder and Search API](https://apis.io/apis/grafana-com/grafana-folder-api/)
- [Grafana Data Source API](https://apis.io/apis/grafana-com/grafana-data-source-api/)
- [Grafana Alerting Provisioning API](https://apis.io/apis/grafana-com/grafana-alerting-api/)
- [Grafana Organization and Users API](https://apis.io/apis/grafana-com/grafana-org-api/)
- [Grafana Access Control (RBAC) API](https://apis.io/apis/grafana-com/grafana-rbac-api/)
- [Grafana Admin API](https://apis.io/apis/grafana-com/grafana-admin-api/)
- [Grafana Library Elements API](https://apis.io/apis/grafana-com/grafana-library-elements-api/)
- [Grafana Correlations API](https://apis.io/apis/grafana-com/grafana-correlations-api/)
- [Grafana Snapshot, Short URL, and Query History API](https://apis.io/apis/grafana-com/grafana-snapshot-shorturl-api/)
- [Grafana Cloud API](https://apis.io/apis/grafana-com/grafana-cloud-api/)

## Tags

Observability, Grafana, Annotations

---

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