Docs: Dashboards and folders: Add annotation and label restriction (#116049)

This commit is contained in:
Stephanie Hingtgen
2026-01-09 21:53:56 +00:00
committed by GitHub
parent 0c8c886930
commit 5ff18c0802
2 changed files with 16 additions and 0 deletions
@@ -231,6 +231,10 @@ JSON Body schema:
- **metadata.annotations.grafana.app/folder** - Optional field, the unique identifier of the folder under which the dashboard should be created.
- **spec** The dashboard json.
{{< admonition type="note" >}}
Custom labels and annotations in the metadata field are supported on some instances, with full support planned for all instances when these APIs reach general availability. If they are not yet supported on your instance, they will be ignored.
{{< /admonition >}}
**Example Response**:
```http
@@ -521,6 +525,10 @@ JSON Body schema:
- **metadata.annotations.grafana.app/message** - Optional field, to set a commit message for the version history.
- **spec** The dashboard json.
{{< admonition type="note" >}}
Custom labels and annotations in the metadata field are supported on some instances, with full support planned for all instances when these APIs reach general availability. If they are not yet supported on your instance, they will be ignored.
{{< /admonition >}}
**Example Response**:
```http
@@ -259,6 +259,10 @@ JSON Body schema:
- **metadata.annotations.grafana.app/folder** - Optional field, the unique identifier of the parent folder under which the folder should be created. Requires nested folders to be enabled.
- **spec.title** The title of the folder.
{{< admonition type="note" >}}
Custom labels and annotations in the metadata field are supported on some instances, with full support planned for all instances when these APIs reach general availability. If they are not yet supported on your instance, they will be ignored.
{{< /admonition >}}
**Example Response**:
```http
@@ -337,6 +341,10 @@ JSON Body schema:
- **metadata.annotations.grafana.app/folder** - Optional field, the unique identifier of the parent folder under which the folder should be - update this to move the folder under a different parent folder. Requires nested folders to be enabled.
- **spec.title** The title of the folder.
{{< admonition type="note" >}}
Custom labels and annotations in the metadata field are supported on some instances, with full support planned for all instances when these APIs reach general availability. If they are not yet supported on your instance, they will be ignored.
{{< /admonition >}}
**Example Response**:
```http