This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Breaking changesbreadcrumb arrow Breaking changes in Grafana v13.0
Grafana Cloud Enterprise Open source

Breaking changes in Grafana v13.0

Following are breaking changes that you should be aware of when upgrading to Grafana v13.0.

For our purposes, a breaking change is any change that requires users or operators to do something. This includes:

  • Changes in one part of the system that could cause other components to fail
  • Deprecations or removal of a feature
  • Changes to an API that could break automation
  • Changes that affect some plugins or functions of Grafana
  • Migrations that can’t be rolled back

For each change, the provided information:

  • Helps you determine if you’re affected
  • Describes the change or relevant background information
  • Guides you in how to mitigate for the change or migrate
  • Provides more learning resources

For release highlights and deprecations, refer to our v13.0 What’s new. For the specific steps we recommend when you upgrade to v13.0, check out our Upgrade guide.

Alerting

Legacy Alertmanager configuration API endpoints changed

You are affected if

You use any of the following endpoints directly, for example in automation scripts or custom tooling:

  • DELETE /api/alertmanager/grafana/config/api/v1/alerts
  • GET /api/alertmanager/grafana/config/api/v1/alerts
  • GET /api/alertmanager/grafana/config/history
  • POST /api/alertmanager/grafana/config/history/{id}/_activate

Description

These endpoints were deprecated in Grafana v12 and rely on legacy single-tenant Alertmanager configuration semantics.

  • DELETE /api/alertmanager/grafana/config/api/v1/alerts has been removed entirely.
  • GET /api/alertmanager/grafana/config/api/v1/alerts is now restricted to admin users. A Warning: 299 response header is included to help identify any remaining automated consumers. The endpoint will be fully removed in Grafana v14.
  • GET /api/alertmanager/grafana/config/history is now restricted to admin users. The endpoint will be fully removed in Grafana v14.
  • POST /api/alertmanager/grafana/config/history/{id}/_activate is now restricted to admin users. The endpoint will be fully removed in Grafana v14.

Migration

Use the Kubernetes-style resource APIs under notifications.alerting.grafana.app/v1beta1:

ResourceAPI path
Receivers/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/receivers
Notification policies/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/routingtrees
Templates/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/templategroups
Mute timings/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/timeintervals
Inhibition rules/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/inhibitionrules