This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.
Grafana HTTP API reference guide
Every Grafana instance exposes an HTTP API, used by the Grafana frontend to manage resources like saving dashboards, creating users, updating data sources, deleting alerts, and more. You can use the HTTP API to programmatically access or manage resources from your Grafana instance.
If you need to manage or access other resources from your Grafana Cloud Stack, refer to the Grafana Cloud API instead.
New generation HTTP APIs
Grafana is deprecating legacy APIs (/api) in favor of a new generation of improved APIs (/apis) which follow a standardized API structure alongside consistent API versioning.
To learn more refer to the new API structure in Grafana and the API migration guide.
The Grafana API specification
HTTP API specs are available in Swagger:
- OpenAPI v2 specification
- OpenAPI v3 specification, generated from the v2 specs
You can browse and try out both via the Swagger UI editor (served by the Grafana server) by navigating to /swagger-ui.
Authentication
In OSS, you can authenticate your requests to the HTTP APIs using basic auth or a service account token. In Grafana Cloud, only the service account token option is available. For more details refer to HTTP API authentication.
