@grafana/openapi 13.1.0-25858739282 → 13.1.0-26657291204

package/dist/api/openapi3.json

@@ -8125,9 +8125,6 @@
           "queryHistory": {
             "$ref": "#/components/schemas/QueryHistoryPreference"
           },
-          "regionalFormat": {
-            "type": "string"
-          },
           "theme": {
             "enum": ["light", "dark"],
             "type": "string"
@@ -8764,6 +8761,10 @@
             "description": "UID for the home dashboard",
             "type": "string"
           },
+          "homeURL": {
+            "description": "Explicit home URL (NOTE: this can only be modified in the system settings)",
+            "type": "string"
+          },
           "language": {
             "description": "Selected language",
             "type": "string"
@@ -8774,10 +8775,6 @@
           "queryHistory": {
             "$ref": "#/components/schemas/PreferencesQueryHistoryPreference"
           },
-          "regionalFormat": {
-            "description": "Selected locale (beta)\nTODO: Will be removed",
-            "type": "string"
-          },
           "theme": {
             "description": "user interface theme",
             "type": "string"
@@ -11437,6 +11434,7 @@
             "type": "string"
           },
           "uid": {
+            "description": "Deprecated: always empty; no per-entry id.",
             "type": "string"
           }
         },
@@ -12267,9 +12265,6 @@
           "queryHistory": {
             "$ref": "#/components/schemas/QueryHistoryPreference"
           },
-          "regionalFormat": {
-            "type": "string"
-          },
           "theme": {
             "enum": ["light", "dark", "system"],
             "type": "string"

package/dist/apis/folder.grafana.app-v1.json

@@ -848,6 +848,14 @@
         "type": "object",
         "required": ["canSave", "canEdit", "canAdmin", "canDelete"],
         "properties": {
+          "accessControl": {
+            "description": "AccessControl is a flat map of folder-domain action strings to bool, reflecting permissions after parent-chain inheritance has been resolved by the authorization system. Mirrors the shape of legacy dtos.Folder.AccessControl so clients can drop their dual call to /api/folders/{uid}?accesscontrol=true. Only keys for actions the user is granted appear here; absent keys mean \"not granted\".",
+            "type": "object",
+            "additionalProperties": {
+              "type": "boolean",
+              "default": false
+            }
+          },
           "apiVersion": {
             "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
             "type": "string"

package/dist/apis/folder.grafana.app-v1beta1.json

@@ -848,6 +848,14 @@
         "type": "object",
         "required": ["canSave", "canEdit", "canAdmin", "canDelete"],
         "properties": {
+          "accessControl": {
+            "description": "AccessControl is a flat map of folder-domain action strings to bool, reflecting permissions after parent-chain inheritance has been resolved by the authorization system. Mirrors the shape of legacy dtos.Folder.AccessControl so clients can drop their dual call to /api/folders/{uid}?accesscontrol=true. Only keys for actions the user is granted appear here; absent keys mean \"not granted\".",
+            "type": "object",
+            "additionalProperties": {
+              "type": "boolean",
+              "default": false
+            }
+          },
           "apiVersion": {
             "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
             "type": "string"

package/dist/apis/iam.grafana.app-v0alpha1.json

@@ -649,7 +649,7 @@
     "/searchExternalGroupMappings": {
       "post": {
         "tags": ["Search"],
-        "description": "Search ExternalGroupMapping resources by the provided external group IDs.",
+        "description": "Returns the team UIDs that map to any of the provided external group IDs.",
         "operationId": "searchExternalGroupMappings",
         "parameters": [
           {
@@ -681,28 +681,6 @@
               "format": "int64"
             },
             "example": 0
-          },
-          {
-            "name": "sort",
-            "in": "query",
-            "description": "sortable field",
-            "schema": {
-              "type": "string"
-            },
-            "examples": {
-              "": {
-                "summary": "default sorting",
-                "value": "externalGroup"
-              },
-              "-externalGroup": {
-                "summary": "externalGroup descending",
-                "value": "-externalGroup"
-              },
-              "externalGroup": {
-                "summary": "externalGroup ascending",
-                "value": "externalGroup"
-              }
-            }
           }
         ],
         "requestBody": {
@@ -3981,6 +3959,54 @@
   },
   "components": {
     "schemas": {
+      "CreateSearchExternalGroupMappingsBody": {
+        "type": "object",
+        "required": ["teams", "totalHits"],
+        "properties": {
+          "teams": {
+            "description": "Deduplicated team UIDs whose spec.externalGroups intersect the request set.",
+            "type": "array",
+            "items": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "totalHits": {
+            "description": "Raw match count; may exceed len(teams) in legacy storage mode where one team can match through multiple group rows. Use to drive pagination, not as a team count.",
+            "type": "integer",
+            "format": "int64",
+            "default": 0
+          }
+        }
+      },
+      "CreateSearchExternalGroupMappingsResponse": {
+        "type": "object",
+        "required": ["teams", "totalHits"],
+        "properties": {
+          "apiVersion": {
+            "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
+            "type": "string"
+          },
+          "kind": {
+            "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+            "type": "string"
+          },
+          "teams": {
+            "description": "Deduplicated team UIDs whose spec.externalGroups intersect the request set.",
+            "type": "array",
+            "items": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "totalHits": {
+            "description": "Raw match count; may exceed len(teams) in legacy storage mode where one team can match through multiple group rows. Use to drive pagination, not as a team count.",
+            "type": "integer",
+            "format": "int64",
+            "default": 0
+          }
+        }
+      },
       "CreateServiceAccountTokenBody": {
         "type": "object",
         "required": ["token", "serviceAccountTokenName", "expires"],
@@ -4533,47 +4559,30 @@
       },
       "GetTeamGroupsBody": {
         "type": "object",
-        "required": ["items"],
+        "required": ["externalGroups"],
         "properties": {
-          "items": {
+          "externalGroups": {
             "type": "array",
             "items": {
-              "default": {}
+              "type": "string",
+              "default": ""
             }
           }
         }
       },
-      "GetTeamGroupsExternalGroupMapping": {
-        "type": "object",
-        "required": ["name", "externalGroup"],
-        "properties": {
-          "externalGroup": {
-            "type": "string",
-            "default": ""
-          },
-          "name": {
-            "type": "string",
-            "default": ""
-          }
-        }
-      },
       "GetTeamGroupsResponse": {
         "type": "object",
-        "required": ["items"],
+        "required": ["externalGroups"],
         "properties": {
           "apiVersion": {
             "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
             "type": "string"
           },
-          "items": {
+          "externalGroups": {
             "type": "array",
             "items": {
-              "default": {},
-              "allOf": [
-                {
-                  "$ref": "#/components/schemas/GetTeamGroupsExternalGroupMapping"
-                }
-              ]
+              "type": "string",
+              "default": ""
             }
           },
           "kind": {
@@ -6180,22 +6189,6 @@
           }
         }
       },
-      "github.com/grafana/grafana/pkg/apis/iam/v0alpha1.IdentityRef": {
-        "type": "object",
-        "required": ["type", "name"],
-        "properties": {
-          "name": {
-            "description": "Name is the unique identifier for identity, guaranteed to be a unique value for the type within a namespace.",
-            "type": "string",
-            "default": ""
-          },
-          "type": {
-            "description": "Type of identity e.g. \"user\". For a full list see https://github.com/grafana/authlib/blob/d6737a7dc8f55e9d42834adb83b5da607ceed293/types/type.go#L15",
-            "type": "string",
-            "default": ""
-          }
-        }
-      },
       "github.com/grafana/grafana/pkg/apis/iam/v0alpha1.TeamMember": {
         "type": "object",
         "required": ["identity", "displayName"],
@@ -6217,7 +6210,7 @@
             "default": {},
             "allOf": [
               {
-                "$ref": "#/components/schemas/github.com~1grafana~1grafana~1pkg~1apis~1iam~1v0alpha1.IdentityRef"
+                "$ref": "#/components/schemas/IdentityRef"
               }
             ]
           },

package/dist/apis/preferences.grafana.app-v1alpha1.json

@@ -289,25 +289,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "required": ["metadata", "spec"],
-                  "properties": {
-                    "apiVersion": {
-                      "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
-                      "type": "string"
-                    },
-                    "kind": {
-                      "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
-                      "type": "string"
-                    },
-                    "metadata": {
-                      "default": {}
-                    },
-                    "spec": {
-                      "description": "Spec is the spec of the Preferences",
-                      "default": {}
-                    }
-                  }
+                  "$ref": "#/components/schemas/Preferences"
                 }
               }
             }
@@ -759,6 +741,10 @@
             "description": "UID for the home dashboard",
             "type": "string"
           },
+          "homeURL": {
+            "description": "Explicit home URL (NOTE: this can only be modified in the system settings)",
+            "type": "string"
+          },
           "language": {
             "description": "Selected language",
             "type": "string"
@@ -779,10 +765,6 @@
               }
             ]
           },
-          "regionalFormat": {
-            "description": "Selected locale (beta)",
-            "type": "string"
-          },
           "theme": {
             "description": "user interface theme",
             "type": "string"

package/dist/apis/provisioning.grafana.app-v0alpha1.json

@@ -3715,29 +3715,6 @@
       ]
     },
     "/repositories/{name}/webhook": {
-      "get": {
-        "tags": ["Repository"],
-        "description": "connect GET requests to webhook of Repository",
-        "operationId": "getRepositoryWebhook",
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "*/*": {
-                "schema": {
-                  "$ref": "#/components/schemas/WebhookResponse"
-                }
-              }
-            }
-          }
-        },
-        "x-kubernetes-action": "connect",
-        "x-kubernetes-group-version-kind": {
-          "group": "provisioning.grafana.app",
-          "version": "v0alpha1",
-          "kind": "WebhookResponse"
-        }
-      },
       "post": {
         "tags": ["Repository"],
         "description": "Currently only supports github webhooks",
@@ -3866,11 +3843,28 @@
           }
         }
       },
+      "BranchOptions": {
+        "type": "object",
+        "properties": {
+          "enforceTemplate": {
+            "description": "When true, the branch name field in Save drawers is read-only.",
+            "type": "boolean"
+          },
+          "nameTemplate": {
+            "description": "Template for the branch name created in branch workflow. Supports variables: {{action}}, {{resourceKind}}, {{title}}, {{userLogin}}, {{random}}. {{random}} is a 6-character alphanumeric token generated at render time to avoid collisions. The result is sanitised to a valid git ref (lowercase, alphanumeric + dashes, max 100 chars). When empty, the current auto-generated name is preserved.",
+            "type": "string"
+          }
+        }
+      },
       "CommitOptions": {
         "type": "object",
         "properties": {
+          "enforceTemplate": {
+            "description": "When true, the Comment field in Save drawers is pre-filled from SingleResourceMessageTemplate and rendered read-only. The Grafana-saved-by trailer is always appended regardless of this setting.",
+            "type": "boolean"
+          },
           "singleResourceMessageTemplate": {
-            "description": "Template for commit messages produced by single-resource UI operations (dashboard save/delete/move, folder create/rename/delete). Bulk operations and sync jobs are out of scope and build their own messages. Supports variables: {{action}}, {{resourceKind}}, {{resourceID}}, {{title}}. When empty, a built-in default is used (e.g. \"Save dashboard: <title>\").",
+            "description": "Template for commit messages produced by single-resource UI operations (dashboard save/delete/move, folder create/rename/delete). Bulk operations and sync jobs are out of scope and build their own messages. Supports variables: {{action}}, {{resourceKind}}, {{resourceID}}, {{title}}, {{userName}}, {{userLogin}}, {{userEmail}}. When empty, a built-in default is used (e.g. \"Save dashboard: <title>\").",
             "type": "string"
           }
         }
@@ -4187,7 +4181,7 @@
             "type": "string"
           },
           "message": {
-            "description": "Message to use when committing the changes in a single commit",
+            "description": "Message to use when committing the changes in a single commit. Deprecated: set JobSpec.Message instead. This field is kept for backwards compatibility and is only used when JobSpec.Message is empty.",
             "type": "string"
           },
           "path": {
@@ -4817,6 +4811,10 @@
               }
             ]
           },
+          "message": {
+            "description": "Commit message for this job. Applies to job actions that produce commits (delete, move, migrate, push, fixFolderMetadata). When empty, the backend falls back to the action-specific message field (ExportJobOptions.Message, MigrateJobOptions.Message) for backwards compatibility, then to a built-in default.",
+            "type": "string"
+          },
           "migrate": {
             "description": "Required when the action is `migrate`",
             "allOf": [
@@ -4956,7 +4954,7 @@
         "type": "object",
         "properties": {
           "message": {
-            "description": "Message to use when committing the changes in a single commit",
+            "description": "Message to use when committing the changes in a single commit. Deprecated: set JobSpec.Message instead. This field is kept for backwards compatibility and is only used when JobSpec.Message is empty.",
             "type": "string"
           },
           "resources": {
@@ -5028,6 +5026,19 @@
           }
         }
       },
+      "PullRequestOptions": {
+        "type": "object",
+        "properties": {
+          "enforceTemplate": {
+            "description": "When true, the PR title field in Save drawers is read-only.",
+            "type": "boolean"
+          },
+          "titleTemplate": {
+            "description": "Template for pull request titles. Supports the same variables as BranchOptions.NameTemplate ({{random}} is available but rarely useful here). When empty, the first line of the commit message is used.",
+            "type": "string"
+          }
+        }
+      },
       "QuotaStatus": {
         "description": "QuotaStatus represents the quota limits configured for this repository. These values come from static configuration and are read-only.",
         "type": "object",
@@ -5214,6 +5225,14 @@
               }
             ]
           },
+          "branch": {
+            "description": "Branch naming options. Only meaningful when Workflows includes \"branch\".",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/BranchOptions"
+              }
+            ]
+          },
           "commit": {
             "description": "Commit message options. Currently only contains the template used by single-resource UI operations; future siblings (bulk, sync) can live here.",
             "allOf": [
@@ -5274,6 +5293,14 @@
               }
             ]
           },
+          "pullRequest": {
+            "description": "Pull request options. Only meaningful when Workflows includes \"branch\".",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/PullRequestOptions"
+              }
+            ]
+          },
           "sync": {
             "description": "Sync settings -- how values are pulled from the repository into grafana",
             "default": {},

package/dist/apis/provisioning.grafana.app-v1beta1.json

@@ -3715,29 +3715,6 @@
       ]
     },
     "/repositories/{name}/webhook": {
-      "get": {
-        "tags": ["Repository"],
-        "description": "connect GET requests to webhook of Repository",
-        "operationId": "getRepositoryWebhook",
-        "responses": {
-          "200": {
-            "description": "OK",
-            "content": {
-              "*/*": {
-                "schema": {
-                  "$ref": "#/components/schemas/WebhookResponse"
-                }
-              }
-            }
-          }
-        },
-        "x-kubernetes-action": "connect",
-        "x-kubernetes-group-version-kind": {
-          "group": "provisioning.grafana.app",
-          "version": "v1beta1",
-          "kind": "WebhookResponse"
-        }
-      },
       "post": {
         "tags": ["Repository"],
         "description": "Currently only supports github webhooks",
@@ -3866,11 +3843,28 @@
           }
         }
       },
+      "BranchOptions": {
+        "type": "object",
+        "properties": {
+          "enforceTemplate": {
+            "description": "When true, the branch name field in Save drawers is read-only.",
+            "type": "boolean"
+          },
+          "nameTemplate": {
+            "description": "Template for the branch name created in branch workflow. Supports variables: {{action}}, {{resourceKind}}, {{title}}, {{userLogin}}, {{random}}. {{random}} is a 6-character alphanumeric token generated at render time to avoid collisions. The result is sanitised to a valid git ref (lowercase, alphanumeric + dashes, max 100 chars). When empty, the current auto-generated name is preserved.",
+            "type": "string"
+          }
+        }
+      },
       "CommitOptions": {
         "type": "object",
         "properties": {
+          "enforceTemplate": {
+            "description": "When true, the Comment field in Save drawers is pre-filled from SingleResourceMessageTemplate and rendered read-only. The Grafana-saved-by trailer is always appended regardless of this setting.",
+            "type": "boolean"
+          },
           "singleResourceMessageTemplate": {
-            "description": "Template for commit messages produced by single-resource UI operations (dashboard save/delete/move, folder create/rename/delete). Bulk operations and sync jobs are out of scope and build their own messages. Supports variables: {{action}}, {{resourceKind}}, {{resourceID}}, {{title}}. When empty, a built-in default is used (e.g. \"Save dashboard: <title>\").",
+            "description": "Template for commit messages produced by single-resource UI operations (dashboard save/delete/move, folder create/rename/delete). Bulk operations and sync jobs are out of scope and build their own messages. Supports variables: {{action}}, {{resourceKind}}, {{resourceID}}, {{title}}, {{userName}}, {{userLogin}}, {{userEmail}}. When empty, a built-in default is used (e.g. \"Save dashboard: <title>\").",
             "type": "string"
           }
         }
@@ -4095,7 +4089,7 @@
             "type": "string"
           },
           "message": {
-            "description": "Message to use when committing the changes in a single commit",
+            "description": "Message to use when committing the changes in a single commit. Deprecated: set JobSpec.Message instead. This field is kept for backwards compatibility and is only used when JobSpec.Message is empty.",
             "type": "string"
           },
           "path": {
@@ -4629,6 +4623,10 @@
           "fixFolderMetadata": {
             "description": "Options when the action is `fix-folder-metadata`"
           },
+          "message": {
+            "description": "Commit message for this job. Applies to job actions that produce commits (delete, move, migrate, push, fixFolderMetadata). When empty, the backend falls back to the action-specific message field (ExportJobOptions.Message, MigrateJobOptions.Message) for backwards compatibility, then to a built-in default.",
+            "type": "string"
+          },
           "migrate": {
             "description": "Required when the action is `migrate`"
           },
@@ -4736,7 +4734,7 @@
         "type": "object",
         "properties": {
           "message": {
-            "description": "Message to use when committing the changes in a single commit",
+            "description": "Message to use when committing the changes in a single commit. Deprecated: set JobSpec.Message instead. This field is kept for backwards compatibility and is only used when JobSpec.Message is empty.",
             "type": "string"
           },
           "resources": {
@@ -4798,6 +4796,19 @@
           }
         }
       },
+      "PullRequestOptions": {
+        "type": "object",
+        "properties": {
+          "enforceTemplate": {
+            "description": "When true, the PR title field in Save drawers is read-only.",
+            "type": "boolean"
+          },
+          "titleTemplate": {
+            "description": "Template for pull request titles. Supports the same variables as BranchOptions.NameTemplate ({{random}} is available but rarely useful here). When empty, the first line of the commit message is used.",
+            "type": "string"
+          }
+        }
+      },
       "QuotaStatus": {
         "description": "QuotaStatus represents the quota limits configured for this repository. These values come from static configuration and are read-only.",
         "type": "object",
@@ -4925,6 +4936,9 @@
           "bitbucket": {
             "description": "The repository on Bitbucket. Mutually exclusive with local | github | git."
           },
+          "branch": {
+            "description": "Branch naming options. Only meaningful when Workflows includes \"branch\"."
+          },
           "commit": {
             "description": "Commit message options. Currently only contains the template used by single-resource UI operations; future siblings (bulk, sync) can live here."
           },
@@ -4950,6 +4964,9 @@
           "local": {
             "description": "The repository on the local file system. Mutually exclusive with local | github."
           },
+          "pullRequest": {
+            "description": "Pull request options. Only meaningful when Workflows includes \"branch\"."
+          },
           "sync": {
             "description": "Sync settings -- how values are pulled from the repository into grafana",
             "default": {}

package/package.json

@@ -2,7 +2,7 @@
   "author": "Grafana Labs",
   "license": "Apache-2.0",
   "name": "@grafana/openapi",
-  "version": "13.1.0-25858739282",
+  "version": "13.1.0-26657291204",
   "description": "Grafana OpenApi Library",
   "keywords": [
     "grafana",