What's new from Grafana Labsbreadcrumb arrow Legacy Alertmanager configuration API endpoints changed
What's new from Grafana Labs
What's new from Grafana Labs
Grafana Cloud Generally Available Open source Enterprise Generally Available Breaking change Alerting
Release date: 2026-04-07

Legacy Alertmanager configuration API endpoints changed

In Grafana v12.0, we deprecated several Alertmanager configuration API endpoints that rely on legacy single-tenant Alertmanager configuration semantics. In Grafana v13.0 we are removing or restricting access to them:

  • DELETE /api/alertmanager/grafana/config/api/v1/alerts is 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 a future release.
  • GET /api/alertmanager/grafana/config/history is now restricted to admin users. The endpoint will be fully removed in a future release.
  • POST /api/alertmanager/grafana/config/history/{id}/_activate is now restricted to admin users. The endpoint will be fully removed in a future release.
  • POST /api/alertmanager/grafana/config/api/v1/receivers/test is removed entirely.

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
  • POST /api/alertmanager/grafana/config/api/v1/receivers/test

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
Receiver testing/apis/notifications.alerting.grafana.app/v1beta1/namespaces/{namespace}/receivers/{uid}/test
Related What's new posts
docs icon 2026-04-07
Added provenance support to alerting notification app platform APIs
docs icon 2026-03-31
Alertmanager status endpoint requires a new permission
docs icon 2026-03-25
Attribution Alerts