●Change8

Migrating to Grafana v12.1.0

Version v12.1.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 7/23/2025

2
Breaking Changes
2
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

Alerting API (Prometheus Rules API)Alerting List V2 UISyncRuleStatePersisterNotification PoliciesAzure Resource Graph queriesStorage (Betterer)

Breaking Changes

●Issue #1

API key authentication endpoints have been removed.

✓Solution

Users relying on API keys for authentication must migrate to alternative methods like OAuth, SAML, or service accounts.

●Issue #2

Code for authenticating API keys has been removed.

✓Solution

If your integration relied on the internal mechanism for API key authentication, it will no longer function. Migrate to supported authentication flows.

Migration Steps

  1. 1
    If you were using API key authentication, you must switch to OAuth, SAML, or other supported authentication mechanisms.
  2. 2
    Review your Alerting configurations, especially regarding Prometheus rule imports and recording rule data source defaults, as behavior has been refined.

Release Summary

Grafana 12.1.0 introduces significant enhancements to Alerting, including OAuth2 support for webhooks, improved Prometheus rule management, and backend optimizations. This release also removes legacy API key authentication endpoints.

Need More Details?

View the full release notes and all changes for Grafana v12.1.0.

View Full Changelog