View a markdown version of this page

New API structure - Amazon Managed Grafana

New API structure

Starting in Grafana version 12, Grafana HTTP APIs are transitioning to a new standardized API structure with consistent versioning. The new APIs follow a Kubernetes-style path format:

/apis/<group>/<version>/namespaces/default/<resource>[/<name>]

Where:

  • group – Organizes related functionality into logical collections. For example, playlist.grafana.app for playlist operations.

  • version – Uses semantic versioning with stability levels: v1alpha1 (experimental), v1beta1 (pre-release), and v1 (GA, stable with backward compatibility guarantees).

  • resource – The resource type, such as playlists or dashboards.

  • name – The unique identifier for a specific resource instance. Used for Get, Update, and Delete operations.

API responses follow a standardized format with kind, apiVersion, metadata, and spec fields.

For more information about the new API structure, see New API Structure in the Grafana Labs documentation.