From 46ace5adacbfd0f35fb461bdf1371364ccc51720 Mon Sep 17 00:00:00 2001 From: drew08t Date: Thu, 2 Nov 2023 21:08:39 -0700 Subject: [PATCH] Revert changes to json files --- public/api-merged.json | 1883 +++++++++++++++++++++++++++++++--------- public/openapi3.json | 1785 ++++++++++++++++++++++++++++--------- 2 files changed, 2863 insertions(+), 805 deletions(-) diff --git a/public/api-merged.json b/public/api-merged.json index 07fc7c71426..ce5e94a3102 100644 --- a/public/api-merged.json +++ b/public/api-merged.json @@ -1,7 +1,14 @@ { - "consumes": ["application/json"], - "produces": ["application/json"], - "schemes": ["http", "https"], + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "schemes": [ + "http", + "https" + ], "swagger": "2.0", "info": { "description": "The Grafana backend exposes an HTTP API, the same API is used by the frontend to do\neverything from saving dashboards, creating users and updating data sources.", @@ -18,7 +25,9 @@ "/access-control/assignments/search": { "post": { "description": "Returns the result of the search through access-control role assignments.\n\nYou need to have a permission with action `teams.roles:read` on scope `teams:*`\nand a permission with action `users.roles:read` on scope `users:*`.", - "tags": ["enterprise"], + "tags": [ + "enterprise" + ], "summary": "Debug permissions.", "operationId": "searchResult", "responses": { @@ -40,7 +49,10 @@ "/access-control/roles": { "get": { "description": "Gets all existing roles. The response contains all global and organization local roles, for the organization which user is signed in.\n\nYou need to have a permission with action `roles:read` and scope `roles:*`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Get all roles.", "operationId": "listRoles", "parameters": [ @@ -64,7 +76,10 @@ }, "post": { "description": "Creates a new custom role and maps given permissions to that role. Note that roles with the same prefix as Fixed Roles can’t be created.\n\nYou need to have a permission with action `roles:write` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only create custom roles with the same, or a subset of permissions which the user has.\nFor example, if a user does not have required permissions for creating users, they won’t be able to create a custom role which allows to do that. This is done to prevent escalation of privileges.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Create a new custom role.", "operationId": "createRole", "parameters": [ @@ -96,7 +111,10 @@ "/access-control/roles/{roleUID}": { "get": { "description": "Get a role for the given UID.\n\nYou need to have a permission with action `roles:read` and scope `roles:*`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Get a role.", "operationId": "getRole", "parameters": [ @@ -121,7 +139,10 @@ }, "put": { "description": "You need to have a permission with action `roles:write` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only create custom roles with the same, or a subset of permissions which the user has.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Update a custom role.", "operationId": "updateRole", "parameters": [ @@ -160,7 +181,10 @@ }, "delete": { "description": "Delete a role with the given UID, and it’s permissions. If the role is assigned to a built-in role, the deletion operation will fail, unless force query param is set to true, and in that case all assignments will also be deleted.\n\nYou need to have a permission with action `roles:delete` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only delete a custom role with the same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to delete a custom role which allows to do that.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Delete a custom role.", "operationId": "deleteRole", "parameters": [ @@ -200,7 +224,10 @@ "/access-control/roles/{roleUID}/assignments": { "get": { "description": "Get role assignments for the role with the given UID.\n\nYou need to have a permission with action `teams.roles:list` and scope `teams:id:*` and `users.roles:list` and scope `users:id:*`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Get role assignments.", "operationId": "getRoleAssignments", "parameters": [ @@ -228,7 +255,10 @@ }, "put": { "description": "Set role assignments for the role with the given UID.\n\nYou need to have a permission with action `teams.roles:add` and `teams.roles:remove` and scope `permissions:type:delegate`, and `users.roles:add` and `users.roles:remove` and scope `permissions:type:delegate`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Set role assignments.", "operationId": "setRoleAssignments", "parameters": [ @@ -266,7 +296,10 @@ "/access-control/status": { "get": { "description": "Returns an indicator to check if fine-grained access control is enabled or not.\n\nYou need to have a permission with action `status:accesscontrol` and scope `services:accesscontrol`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Get status.", "operationId": "getAccessControlStatus", "responses": { @@ -288,7 +321,10 @@ "/access-control/teams/{teamId}/roles": { "get": { "description": "You need to have a permission with action `teams.roles:read` and scope `teams:id:\u003cteam ID\u003e`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Get team roles.", "operationId": "listTeamRoles", "parameters": [ @@ -317,7 +353,10 @@ }, "put": { "description": "You need to have a permission with action `teams.roles:add` and `teams.roles:remove` and scope `permissions:type:delegate` for each.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Update team role.", "operationId": "setTeamRoles", "parameters": [ @@ -349,7 +388,10 @@ }, "post": { "description": "You need to have a permission with action `teams.roles:add` and scope `permissions:type:delegate`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Add team role.", "operationId": "addTeamRole", "parameters": [ @@ -391,7 +433,10 @@ "/access-control/teams/{teamId}/roles/{roleUID}": { "delete": { "description": "You need to have a permission with action `teams.roles:remove` and scope `permissions:type:delegate`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Remove team role.", "operationId": "removeTeamRole", "parameters": [ @@ -431,7 +476,10 @@ "/access-control/users/{userId}/roles": { "get": { "description": "Lists the roles that have been directly assigned to a given user. The list does not include built-in roles (Viewer, Editor, Admin or Grafana Admin), and it does not include roles that have been inherited from a team.\n\nYou need to have a permission with action `users.roles:read` and scope `users:id:\u003cuser ID\u003e`.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "List roles assigned to a user.", "operationId": "listUserRoles", "parameters": [ @@ -460,7 +508,10 @@ }, "put": { "description": "Update the user’s role assignments to match the provided set of UIDs. This will remove any assigned roles that aren’t in the request and add roles that are in the set but are not already assigned to the user.\nIf you want to add or remove a single role, consider using Add a user role assignment or Remove a user role assignment instead.\n\nYou need to have a permission with action `users.roles:add` and `users.roles:remove` and scope `permissions:type:delegate` for each. `permissions:type:delegate` scope ensures that users can only assign or unassign roles which have same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to assign or unassign a role which will allow to do that. This is done to prevent escalation of privileges.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Set user role assignments.", "operationId": "setUserRoles", "parameters": [ @@ -500,7 +551,10 @@ }, "post": { "description": "Assign a role to a specific user. For bulk updates consider Set user role assignments.\n\nYou need to have a permission with action `users.roles:add` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only assign roles which have same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to assign a role which will allow to do that. This is done to prevent escalation of privileges.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Add a user role assignment.", "operationId": "addUserRole", "parameters": [ @@ -539,7 +593,10 @@ "/access-control/users/{userId}/roles/{roleUID}": { "delete": { "description": "Revoke a role from a user. For bulk updates consider Set user role assignments.\n\nYou need to have a permission with action `users.roles:remove` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only unassign roles which have same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to unassign a role which will allow to do that. This is done to prevent escalation of privileges.", - "tags": ["access_control", "enterprise"], + "tags": [ + "access_control", + "enterprise" + ], "summary": "Remove a user role assignment.", "operationId": "removeUserRole", "parameters": [ @@ -585,7 +642,10 @@ "/admin/ldap-sync-status": { "get": { "description": "You need to have a permission with action `ldap.status:read`.", - "tags": ["ldap_debug", "enterprise"], + "tags": [ + "ldap_debug", + "enterprise" + ], "summary": "Returns the current state of the LDAP background sync integration.", "operationId": "getSyncStatus", "responses": { @@ -612,7 +672,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `ldap.config:reload`.", - "tags": ["admin_ldap"], + "tags": [ + "admin_ldap" + ], "summary": "Reloads the LDAP configuration.", "operationId": "reloadLDAPCfg", "responses": { @@ -639,7 +701,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `ldap.status:read`.", - "tags": ["admin_ldap"], + "tags": [ + "admin_ldap" + ], "summary": "Attempts to connect to all the configured LDAP servers and returns information on whenever they're available or not.", "operationId": "getLDAPStatus", "responses": { @@ -666,7 +730,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `ldap.user:sync`.", - "tags": ["admin_ldap"], + "tags": [ + "admin_ldap" + ], "summary": "Enables a single Grafana user to be synchronized against LDAP.", "operationId": "postSyncUserWithLDAP", "parameters": [ @@ -702,7 +768,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `ldap.user:read`.", - "tags": ["admin_ldap"], + "tags": [ + "admin_ldap" + ], "summary": "Finds an user based on a username in LDAP. This helps illustrate how would the particular user be mapped in Grafana when synced.", "operationId": "getUserFromLDAP", "parameters": [ @@ -736,7 +804,9 @@ "basic": [] } ], - "tags": ["admin"], + "tags": [ + "admin" + ], "summary": "Pause/unpause all (legacy) alerts.", "operationId": "pauseAllAlerts", "parameters": [ @@ -767,7 +837,10 @@ }, "/admin/provisioning/access-control/reload": { "post": { - "tags": ["access_control_provisioning", "enterprise"], + "tags": [ + "access_control_provisioning", + "enterprise" + ], "summary": "You need to have a permission with action `provisioning:reload` with scope `provisioners:accesscontrol`.", "operationId": "adminProvisioningReloadAccessControl", "responses": { @@ -791,7 +864,9 @@ } ], "description": "Reloads the provisioning config files for dashboards again. It won’t return until the new provisioned entities are already stored in the database. In case of dashboards, it will stop polling for changes in dashboard files and then restart it with new configurations after returning.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `provisioning:reload` and scope `provisioners:dashboards`.", - "tags": ["admin_provisioning"], + "tags": [ + "admin_provisioning" + ], "summary": "Reload dashboard provisioning configurations.", "operationId": "adminProvisioningReloadDashboards", "responses": { @@ -818,7 +893,9 @@ } ], "description": "Reloads the provisioning config files for datasources again. It won’t return until the new provisioned entities are already stored in the database. In case of dashboards, it will stop polling for changes in dashboard files and then restart it with new configurations after returning.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `provisioning:reload` and scope `provisioners:datasources`.", - "tags": ["admin_provisioning"], + "tags": [ + "admin_provisioning" + ], "summary": "Reload datasource provisioning configurations.", "operationId": "adminProvisioningReloadDatasources", "responses": { @@ -845,7 +922,9 @@ } ], "description": "Reloads the provisioning config files for legacy alert notifiers again. It won’t return until the new provisioned entities are already stored in the database. In case of dashboards, it will stop polling for changes in dashboard files and then restart it with new configurations after returning.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `provisioning:reload` and scope `provisioners:notifications`.", - "tags": ["admin_provisioning"], + "tags": [ + "admin_provisioning" + ], "summary": "Reload legacy alert notifier provisioning configurations.", "operationId": "adminProvisioningReloadNotifications", "responses": { @@ -872,7 +951,9 @@ } ], "description": "Reloads the provisioning config files for plugins again. It won’t return until the new provisioned entities are already stored in the database. In case of dashboards, it will stop polling for changes in dashboard files and then restart it with new configurations after returning.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `provisioning:reload` and scope `provisioners:plugin`.", - "tags": ["admin_provisioning"], + "tags": [ + "admin_provisioning" + ], "summary": "Reload plugin provisioning configurations.", "operationId": "adminProvisioningReloadPlugins", "responses": { @@ -899,7 +980,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `settings:read` and scopes: `settings:*`, `settings:auth.saml:` and `settings:auth.saml:enabled` (property level).", - "tags": ["admin"], + "tags": [ + "admin" + ], "summary": "Fetch settings.", "operationId": "adminGetSettings", "responses": { @@ -918,7 +1001,9 @@ "/admin/stats": { "get": { "description": "Only works with Basic Authentication (username and password). See introduction for an explanation.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `server:stats:read`.", - "tags": ["admin"], + "tags": [ + "admin" + ], "summary": "Fetch Grafana Stats.", "operationId": "adminGetStats", "responses": { @@ -945,7 +1030,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users:create`.\nNote that OrgId is an optional parameter that can be used to assign a new user to a different organization when `auto_assign_org` is set to `true`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Create new user.", "operationId": "adminCreateUser", "parameters": [ @@ -988,7 +1075,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users:delete` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Delete global User.", "operationId": "adminDeleteUser", "parameters": [ @@ -1027,7 +1116,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.authtoken:list` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Return a list of all auth tokens (devices) that the user currently have logged in from.", "operationId": "adminGetUserAuthTokens", "parameters": [ @@ -1063,7 +1154,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users:disable` and scope `global.users:1` (userIDScope).", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Disable user.", "operationId": "adminDisableUser", "parameters": [ @@ -1102,7 +1195,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users:enable` and scope `global.users:1` (userIDScope).", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Enable user.", "operationId": "adminEnableUser", "parameters": [ @@ -1141,7 +1236,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.logout` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Logout user revokes all auth tokens (devices) for the user. User of issued auth tokens (devices) will no longer be logged in and will be required to authenticate again upon next activity.", "operationId": "adminLogoutUser", "parameters": [ @@ -1183,7 +1280,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.password:update` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Set password for user.", "operationId": "adminUpdateUserPassword", "parameters": [ @@ -1225,7 +1324,9 @@ "/admin/users/{user_id}/permissions": { "put": { "description": "Only works with Basic Authentication (username and password). See introduction for an explanation.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.permissions:update` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Set permissions for user.", "operationId": "adminUpdateUserPermissions", "parameters": [ @@ -1272,7 +1373,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.quotas:list` and scope `global.users:1` (userIDScope).", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Fetch user quota.", "operationId": "getUserQuota", "parameters": [ @@ -1311,7 +1414,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.quotas:update` and scope `global.users:1` (userIDScope).", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Update user quota.", "operationId": "updateUserQuota", "parameters": [ @@ -1364,7 +1469,9 @@ } ], "description": "Revokes the given auth token (device) for the user. User of issued auth token (device) will no longer be logged in and will be required to authenticate again upon next activity.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `users.authtoken:update` and scope `global.users:*`.", - "tags": ["admin_users"], + "tags": [ + "admin_users" + ], "summary": "Revoke auth token for user.", "operationId": "adminRevokeUserAuthToken", "parameters": [ @@ -1409,7 +1516,9 @@ "/alert-notifications": { "get": { "description": "Returns all notification channels that the authenticated user has permission to view.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Get all notification channels.", "operationId": "getAlertNotificationChannels", "responses": { @@ -1429,7 +1538,9 @@ }, "post": { "description": "You can find the full list of [supported notifiers](https://grafana.com/docs/grafana/latest/alerting/old-alerting/notifications/#list-of-supported-notifiers) on the alert notifiers page.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Create notification channel.", "operationId": "createAlertNotificationChannel", "parameters": [ @@ -1464,7 +1575,9 @@ "/alert-notifications/lookup": { "get": { "description": "Returns all notification channels, but with less detailed information. Accessible by any authenticated user and is mainly used by providing alert notification channels in Grafana UI when configuring alert rule.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Get all notification channels (lookup).", "operationId": "getAlertNotificationLookup", "responses": { @@ -1486,7 +1599,9 @@ "/alert-notifications/test": { "post": { "description": "Sends a test notification to the channel.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Test notification channel.", "operationId": "notificationChannelTest", "parameters": [ @@ -1524,7 +1639,9 @@ "/alert-notifications/uid/{notification_channel_uid}": { "get": { "description": "Returns the notification channel given the notification channel UID.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Get notification channel by UID.", "operationId": "getAlertNotificationChannelByUID", "parameters": [ @@ -1555,7 +1672,9 @@ }, "put": { "description": "Updates an existing notification channel identified by uid.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Update notification channel by UID.", "operationId": "updateAlertNotificationChannelByUID", "parameters": [ @@ -1594,7 +1713,9 @@ }, "delete": { "description": "Deletes an existing notification channel identified by UID.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Delete alert notification by UID.", "operationId": "deleteAlertNotificationChannelByUID", "parameters": [ @@ -1627,7 +1748,9 @@ "/alert-notifications/{notification_channel_id}": { "get": { "description": "Returns the notification channel given the notification channel ID.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Get notification channel by ID.", "operationId": "getAlertNotificationChannelByID", "parameters": [ @@ -1659,7 +1782,9 @@ }, "put": { "description": "Updates an existing notification channel identified by ID.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Update notification channel by ID.", "operationId": "updateAlertNotificationChannel", "parameters": [ @@ -1699,7 +1824,9 @@ }, "delete": { "description": "Deletes an existing notification channel identified by ID.", - "tags": ["legacy_alerts_notification_channels"], + "tags": [ + "legacy_alerts_notification_channels" + ], "summary": "Delete alert notification by ID.", "operationId": "deleteAlertNotificationChannel", "parameters": [ @@ -1732,7 +1859,9 @@ }, "/alerts": { "get": { - "tags": ["legacy_alerts"], + "tags": [ + "legacy_alerts" + ], "summary": "Get legacy alerts.", "operationId": "getAlerts", "parameters": [ @@ -1759,7 +1888,15 @@ "in": "query" }, { - "enum": ["all", "no_data", "paused", "alerting", "ok", "pending", "unknown"], + "enum": [ + "all", + "no_data", + "paused", + "alerting", + "ok", + "pending", + "unknown" + ], "type": "string", "description": "Return alerts with one or more of the following alert states", "name": "state", @@ -1814,7 +1951,9 @@ }, "/alerts/states-for-dashboard": { "get": { - "tags": ["legacy_alerts"], + "tags": [ + "legacy_alerts" + ], "summary": "Get alert states for a dashboard.", "operationId": "getDashboardStates", "parameters": [ @@ -1841,7 +1980,9 @@ }, "/alerts/test": { "post": { - "tags": ["legacy_alerts"], + "tags": [ + "legacy_alerts" + ], "summary": "Test alert.", "operationId": "testAlert", "parameters": [ @@ -1875,7 +2016,9 @@ "/alerts/{alert_id}": { "get": { "description": "“evalMatches” data in the response is cached in the db when and only when the state of the alert changes (e.g. transitioning from “ok” to “alerting” state).\nIf data from one server triggers the alert first and, before that server is seen leaving alerting state, a second server also enters a state that would trigger the alert, the second server will not be visible in “evalMatches” data.", - "tags": ["legacy_alerts"], + "tags": [ + "legacy_alerts" + ], "summary": "Get alert by ID.", "operationId": "getAlertByID", "parameters": [ @@ -1901,7 +2044,9 @@ }, "/alerts/{alert_id}/pause": { "post": { - "tags": ["legacy_alerts"], + "tags": [ + "legacy_alerts" + ], "summary": "Pause/unpause alert by id.", "operationId": "pauseAlert", "parameters": [ @@ -1942,7 +2087,9 @@ "/annotations": { "get": { "description": "Starting in Grafana v6.4 regions annotations are now returned in one entity that now includes the timeEnd property.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Find Annotations.", "operationId": "getAnnotations", "parameters": [ @@ -2012,7 +2159,10 @@ "in": "query" }, { - "enum": ["alert", "annotation"], + "enum": [ + "alert", + "annotation" + ], "type": "string", "description": "Return alerts or user created annotations", "name": "type", @@ -2039,7 +2189,9 @@ }, "post": { "description": "Creates an annotation in the Grafana database. The dashboardId and panelId fields are optional. If they are not specified then an organization annotation is created and can be queried in any dashboard that adds the Grafana annotations data source. When creating a region annotation include the timeEnd property.\nThe format for `time` and `timeEnd` should be epoch numbers in millisecond resolution.\nThe response for this HTTP request is slightly different in versions prior to v6.4. In prior versions you would also get an endId if you where creating a region. But in 6.4 regions are represented using a single event with time and timeEnd properties.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Create Annotation.", "operationId": "postAnnotation", "parameters": [ @@ -2074,7 +2226,9 @@ "/annotations/graphite": { "post": { "description": "Creates an annotation by using Graphite-compatible event format. The `when` and `data` fields are optional. If `when` is not specified then the current time will be used as annotation’s timestamp. The `tags` field can also be in prior to Graphite `0.10.0` format (string with multiple tags being separated by a space).", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Create Annotation in Graphite format.", "operationId": "postGraphiteAnnotation", "parameters": [ @@ -2108,7 +2262,9 @@ }, "/annotations/mass-delete": { "post": { - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Delete multiple annotations.", "operationId": "massDeleteAnnotations", "parameters": [ @@ -2137,7 +2293,9 @@ "/annotations/tags": { "get": { "description": "Find all the event tags created in the annotations.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Find Annotations Tags.", "operationId": "getAnnotationTags", "parameters": [ @@ -2170,7 +2328,9 @@ }, "/annotations/{annotation_id}": { "get": { - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Get Annotation by ID.", "operationId": "getAnnotationByID", "parameters": [ @@ -2195,7 +2355,9 @@ }, "put": { "description": "Updates all properties of an annotation that matches the specified id. To only update certain property, consider using the Patch Annotation operation.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Update Annotation.", "operationId": "updateAnnotation", "parameters": [ @@ -2234,7 +2396,9 @@ }, "delete": { "description": "Deletes the annotation that matches the specified ID.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Delete Annotation By ID.", "operationId": "deleteAnnotationByID", "parameters": [ @@ -2262,7 +2426,9 @@ }, "patch": { "description": "Updates one or more properties of an annotation that matches the specified ID.\nThis operation currently supports updating of the `text`, `tags`, `time` and `timeEnd` properties.\nThis is available in Grafana 6.0.0-beta2 and above.", - "tags": ["annotations"], + "tags": [ + "annotations" + ], "summary": "Patch Annotation.", "operationId": "patchAnnotation", "parameters": [ @@ -2302,7 +2468,9 @@ }, "/api/v1/provisioning/alert-rules": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get all the alert rules.", "operationId": "RouteGetAlertRules", "responses": { @@ -2315,8 +2483,12 @@ } }, "post": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Create a new alert rule.", "operationId": "RoutePostAlertRule", "parameters": [ @@ -2351,7 +2523,9 @@ }, "/api/v1/provisioning/alert-rules/export": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Export all alert rules in provisioning file format.", "operationId": "RouteGetAlertRulesExport", "parameters": [ @@ -2406,7 +2580,9 @@ }, "/api/v1/provisioning/alert-rules/{UID}": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get a specific alert rule by UID.", "operationId": "RouteGetAlertRule", "parameters": [ @@ -2431,8 +2607,12 @@ } }, "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Update an existing alert rule.", "operationId": "RoutePutAlertRule", "parameters": [ @@ -2472,7 +2652,9 @@ } }, "delete": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Delete a specific alert rule by UID.", "operationId": "RouteDeleteAlertRule", "parameters": [ @@ -2493,8 +2675,14 @@ }, "/api/v1/provisioning/alert-rules/{UID}/export": { "get": { - "produces": ["application/json", "application/yaml", "text/yaml"], - "tags": ["provisioning"], + "produces": [ + "application/json", + "application/yaml", + "text/yaml" + ], + "tags": [ + "provisioning" + ], "summary": "Export an alert rule in provisioning file format.", "operationId": "RouteGetAlertRuleExport", "parameters": [ @@ -2535,7 +2723,9 @@ }, "/api/v1/provisioning/contact-points": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get all the contact points.", "operationId": "RouteGetContactpoints", "parameters": [ @@ -2556,8 +2746,12 @@ } }, "post": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Create a contact point.", "operationId": "RoutePostContactpoints", "parameters": [ @@ -2587,7 +2781,9 @@ }, "/api/v1/provisioning/contact-points/export": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Export all contact points in provisioning file format.", "operationId": "RouteGetContactpointsExport", "parameters": [ @@ -2637,8 +2833,12 @@ }, "/api/v1/provisioning/contact-points/{UID}": { "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Update an existing contact point.", "operationId": "RoutePutContactpoint", "parameters": [ @@ -2673,8 +2873,12 @@ } }, "delete": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Delete a contact point.", "operationId": "RouteDeleteContactpoints", "parameters": [ @@ -2695,7 +2899,9 @@ }, "/api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get a rule group.", "operationId": "RouteGetAlertRuleGroup", "parameters": [ @@ -2725,8 +2931,12 @@ } }, "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Update the interval of a rule group.", "operationId": "RoutePutAlertRuleGroup", "parameters": [ @@ -2768,8 +2978,14 @@ }, "/api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}/export": { "get": { - "produces": ["application/json", "application/yaml", "text/yaml"], - "tags": ["provisioning"], + "produces": [ + "application/json", + "application/yaml", + "text/yaml" + ], + "tags": [ + "provisioning" + ], "summary": "Export an alert rule group in provisioning file format.", "operationId": "RouteGetAlertRuleGroupExport", "parameters": [ @@ -2815,7 +3031,9 @@ }, "/api/v1/provisioning/mute-timings": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get all the mute timings.", "operationId": "RouteGetMuteTimings", "responses": { @@ -2828,8 +3046,12 @@ } }, "post": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Create a new mute timing.", "operationId": "RoutePostMuteTiming", "parameters": [ @@ -2859,7 +3081,9 @@ }, "/api/v1/provisioning/mute-timings/{name}": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get a mute timing.", "operationId": "RouteGetMuteTiming", "parameters": [ @@ -2884,8 +3108,12 @@ } }, "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Replace an existing mute timing.", "operationId": "RoutePutMuteTiming", "parameters": [ @@ -2920,7 +3148,9 @@ } }, "delete": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Delete a mute timing.", "operationId": "RouteDeleteMuteTiming", "parameters": [ @@ -2941,7 +3171,9 @@ }, "/api/v1/provisioning/policies": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get the notification policy tree.", "operationId": "RouteGetPolicyTree", "responses": { @@ -2954,8 +3186,12 @@ } }, "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Sets the notification policy tree.", "operationId": "RoutePutPolicyTree", "parameters": [ @@ -2984,8 +3220,12 @@ } }, "delete": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Clears the notification policy tree.", "operationId": "RouteResetPolicyTree", "responses": { @@ -3000,7 +3240,9 @@ }, "/api/v1/provisioning/policies/export": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Export the notification policy tree in provisioning file format.", "operationId": "RouteGetPolicyTreeExport", "responses": { @@ -3021,7 +3263,9 @@ }, "/api/v1/provisioning/templates": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get all notification templates.", "operationId": "RouteGetTemplates", "responses": { @@ -3039,7 +3283,9 @@ }, "/api/v1/provisioning/templates/{name}": { "get": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Get a notification template.", "operationId": "RouteGetTemplate", "parameters": [ @@ -3064,8 +3310,12 @@ } }, "put": { - "consumes": ["application/json"], - "tags": ["provisioning"], + "consumes": [ + "application/json" + ], + "tags": [ + "provisioning" + ], "summary": "Updates an existing notification template.", "operationId": "RoutePutTemplate", "parameters": [ @@ -3100,7 +3350,9 @@ } }, "delete": { - "tags": ["provisioning"], + "tags": [ + "provisioning" + ], "summary": "Delete a template.", "operationId": "RouteDeleteTemplate", "parameters": [ @@ -3122,7 +3374,9 @@ "/auth/keys": { "get": { "description": "Will return auth keys.\n\nDeprecated: true.\n\nDeprecated. Please use GET /api/serviceaccounts and GET /api/serviceaccounts/{id}/tokens instead\nsee https://grafana.com/docs/grafana/next/administration/api-keys/#migrate-api-keys-to-grafana-service-accounts-using-the-api.", - "tags": ["api_keys"], + "tags": [ + "api_keys" + ], "summary": "Get auth keys.", "operationId": "getAPIkeys", "parameters": [ @@ -3154,7 +3408,9 @@ }, "post": { "description": "Will return details of the created API key.", - "tags": ["api_keys"], + "tags": [ + "api_keys" + ], "summary": "Creates an API key.", "operationId": "addAPIkey", "deprecated": true, @@ -3193,7 +3449,9 @@ "/auth/keys/{id}": { "delete": { "description": "Deletes an API key.\nDeprecated. See: https://grafana.com/docs/grafana/next/administration/api-keys/#migrate-api-keys-to-grafana-service-accounts-using-the-api.", - "tags": ["api_keys"], + "tags": [ + "api_keys" + ], "summary": "Delete API key.", "operationId": "deleteAPIkey", "deprecated": true, @@ -3227,7 +3485,9 @@ }, "/dashboard/snapshots": { "get": { - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "List snapshots.", "operationId": "searchDashboardSnapshots", "parameters": [ @@ -3258,8 +3518,13 @@ }, "/dashboards/calculate-diff": { "post": { - "produces": ["application/json", "text/html"], - "tags": ["dashboards"], + "produces": [ + "application/json", + "text/html" + ], + "tags": [ + "dashboards" + ], "summary": "Perform diff on two dashboards.", "operationId": "calculateDashboardDiff", "parameters": [ @@ -3276,7 +3541,10 @@ "diffType": { "description": "The type of diff to return\nDescription:\n`basic`\n`json`", "type": "string", - "enum": ["basic", "json"] + "enum": [ + "basic", + "json" + ] }, "new": { "$ref": "#/definitions/CalculateDiffTarget" @@ -3304,7 +3572,9 @@ "/dashboards/db": { "post": { "description": "Creates a new dashboard or updates an existing dashboard.", - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Create / Update dashboard", "operationId": "postDashboard", "parameters": [ @@ -3347,7 +3617,9 @@ }, "/dashboards/home": { "get": { - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Get home dashboard.", "operationId": "getHomeDashboard", "responses": { @@ -3366,7 +3638,9 @@ "/dashboards/id/{DashboardID}/permissions": { "get": { "description": "Please refer to [updated API](#/dashboard_permissions/getDashboardPermissionsListByUID) instead", - "tags": ["dashboard_permissions"], + "tags": [ + "dashboard_permissions" + ], "summary": "Gets all existing permissions for the given dashboard.", "operationId": "getDashboardPermissionsListByID", "deprecated": true, @@ -3399,7 +3673,9 @@ }, "post": { "description": "Please refer to [updated API](#/dashboard_permissions/updateDashboardPermissionsByUID) instead\n\nThis operation will remove existing permissions if they’re not included in the request.", - "tags": ["dashboard_permissions"], + "tags": [ + "dashboard_permissions" + ], "summary": "Updates permissions for a dashboard.", "operationId": "updateDashboardPermissionsByID", "deprecated": true, @@ -3445,7 +3721,9 @@ "/dashboards/id/{DashboardID}/restore": { "post": { "description": "Please refer to [updated API](#/dashboard_versions/restoreDashboardVersionByUID) instead", - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Restore a dashboard to a given dashboard version.", "operationId": "restoreDashboardVersionByID", "deprecated": true, @@ -3488,7 +3766,9 @@ "/dashboards/id/{DashboardID}/versions": { "get": { "description": "Please refer to [updated API](#/dashboard_versions/getDashboardVersionsByUID) instead", - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Gets all existing versions for the dashboard.", "operationId": "getDashboardVersionsByID", "deprecated": true, @@ -3523,7 +3803,9 @@ "/dashboards/id/{DashboardID}/versions/{DashboardVersionID}": { "get": { "description": "Please refer to [updated API](#/dashboard_versions/getDashboardVersionByUID) instead", - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Get a specific dashboard version.", "operationId": "getDashboardVersionByID", "deprecated": true, @@ -3564,7 +3846,9 @@ }, "/dashboards/import": { "post": { - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Import dashboard.", "operationId": "importDashboard", "parameters": [ @@ -3602,7 +3886,9 @@ "/dashboards/public-dashboards": { "get": { "description": "Get list of public dashboards", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "listPublicDashboards", "responses": { "200": { @@ -3622,7 +3908,9 @@ }, "/dashboards/tags": { "get": { - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Get all dashboards tags of an organisation.", "operationId": "getDashboardTags", "responses": { @@ -3641,7 +3929,9 @@ "/dashboards/uid/{dashboardUid}/public-dashboards": { "get": { "description": "Get public dashboard by dashboardUid", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "getPublicDashboard", "parameters": [ { @@ -3674,8 +3964,12 @@ }, "post": { "description": "Create public dashboard for a dashboard", - "produces": ["application/json"], - "tags": ["dashboard_public"], + "produces": [ + "application/json" + ], + "tags": [ + "dashboard_public" + ], "operationId": "createPublicDashboard", "parameters": [ { @@ -3715,7 +4009,9 @@ "/dashboards/uid/{dashboardUid}/public-dashboards/{uid}": { "delete": { "description": "Delete public dashboard for a dashboard", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "deletePublicDashboard", "parameters": [ { @@ -3751,8 +4047,12 @@ }, "patch": { "description": "Update public dashboard for a dashboard", - "produces": ["application/json"], - "tags": ["dashboard_public"], + "produces": [ + "application/json" + ], + "tags": [ + "dashboard_public" + ], "operationId": "updatePublicDashboard", "parameters": [ { @@ -3798,7 +4098,9 @@ "/dashboards/uid/{uid}": { "get": { "description": "Will return the dashboard given the dashboard unique identifier (uid).", - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Get dashboard by uid.", "operationId": "getDashboardByUID", "parameters": [ @@ -3829,7 +4131,9 @@ }, "delete": { "description": "Will delete the dashboard given the specified unique identifier (uid).", - "tags": ["dashboards"], + "tags": [ + "dashboards" + ], "summary": "Delete dashboard by uid.", "operationId": "deleteDashboardByUID", "parameters": [ @@ -3861,7 +4165,9 @@ }, "/dashboards/uid/{uid}/permissions": { "get": { - "tags": ["dashboard_permissions"], + "tags": [ + "dashboard_permissions" + ], "summary": "Gets all existing permissions for the given dashboard.", "operationId": "getDashboardPermissionsListByUID", "parameters": [ @@ -3892,7 +4198,9 @@ }, "post": { "description": "This operation will remove existing permissions if they’re not included in the request.", - "tags": ["dashboard_permissions"], + "tags": [ + "dashboard_permissions" + ], "summary": "Updates permissions for a dashboard.", "operationId": "updateDashboardPermissionsByUID", "parameters": [ @@ -3935,7 +4243,9 @@ }, "/dashboards/uid/{uid}/restore": { "post": { - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Restore a dashboard to a given dashboard version using UID.", "operationId": "restoreDashboardVersionByUID", "parameters": [ @@ -3975,7 +4285,9 @@ }, "/dashboards/uid/{uid}/versions": { "get": { - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Gets all existing versions for the dashboard using UID.", "operationId": "getDashboardVersionsByUID", "parameters": [ @@ -4023,7 +4335,9 @@ }, "/dashboards/uid/{uid}/versions/{DashboardVersionID}": { "get": { - "tags": ["dashboard_versions"], + "tags": [ + "dashboard_versions" + ], "summary": "Get a specific dashboard version using UID.", "operationId": "getDashboardVersionByUID", "parameters": [ @@ -4063,7 +4377,9 @@ "/datasources": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scope: `datasources:*`.", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Get all data sources.", "operationId": "getDataSources", "responses": { @@ -4083,7 +4399,9 @@ }, "post": { "description": "By defining `password` and `basicAuthPassword` under secureJsonData property\nGrafana encrypts them securely as an encrypted blob in the database.\nThe response then lists the encrypted fields under secureJsonFields.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:create`", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Create a data source.", "operationId": "addDataSource", "parameters": [ @@ -4117,7 +4435,9 @@ }, "/datasources/correlations": { "get": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Gets all correlations.", "operationId": "getCorrelations", "parameters": [ @@ -4168,7 +4488,9 @@ "/datasources/id/{name}": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Get data source Id by Name.", "operationId": "getDataSourceIdByName", "parameters": [ @@ -4201,7 +4523,9 @@ "/datasources/name/{name}": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Get a single data source by Name.", "operationId": "getDataSourceByName", "parameters": [ @@ -4229,7 +4553,9 @@ }, "delete": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Delete an existing data source by name.", "operationId": "deleteDataSourceByName", "parameters": [ @@ -4262,7 +4588,9 @@ "/datasources/proxy/uid/{uid}/{datasource_proxy_route}": { "get": { "description": "Proxies all calls to the actual data source.", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy GET calls.", "operationId": "datasourceProxyGETByUIDcalls", "parameters": [ @@ -4302,7 +4630,9 @@ }, "post": { "description": "Proxies all calls to the actual data source. The data source should support POST methods for the specific path and role as defined", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy POST calls.", "operationId": "datasourceProxyPOSTByUIDcalls", "parameters": [ @@ -4351,7 +4681,9 @@ }, "delete": { "description": "Proxies all calls to the actual data source.", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy DELETE calls.", "operationId": "datasourceProxyDELETEByUIDcalls", "parameters": [ @@ -4393,7 +4725,9 @@ "/datasources/proxy/{id}/{datasource_proxy_route}": { "get": { "description": "Proxies all calls to the actual data source.\n\nPlease refer to [updated API](#/datasources/datasourceProxyGETByUIDcalls) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy GET calls.", "operationId": "datasourceProxyGETcalls", "deprecated": true, @@ -4434,7 +4768,9 @@ }, "post": { "description": "Proxies all calls to the actual data source. The data source should support POST methods for the specific path and role as defined\n\nPlease refer to [updated API](#/datasources/datasourceProxyPOSTByUIDcalls) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy POST calls.", "operationId": "datasourceProxyPOSTcalls", "deprecated": true, @@ -4484,7 +4820,9 @@ }, "delete": { "description": "Proxies all calls to the actual data source.\n\nPlease refer to [updated API](#/datasources/datasourceProxyDELETEByUIDcalls) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Data source proxy DELETE calls.", "operationId": "datasourceProxyDELETEcalls", "deprecated": true, @@ -4526,7 +4864,9 @@ }, "/datasources/uid/{sourceUID}/correlations": { "get": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Gets all correlations originating from the given data source.", "operationId": "getCorrelationsBySourceUID", "parameters": [ @@ -4553,7 +4893,9 @@ } }, "post": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Add correlation.", "operationId": "createCorrelation", "parameters": [ @@ -4596,7 +4938,9 @@ }, "/datasources/uid/{sourceUID}/correlations/{correlationUID}": { "get": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Gets a correlation.", "operationId": "getCorrelation", "parameters": [ @@ -4629,7 +4973,9 @@ } }, "patch": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Updates a correlation.", "operationId": "updateCorrelation", "parameters": [ @@ -4678,7 +5024,9 @@ "/datasources/uid/{uid}": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:kLtEtcRGk` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Get a single data source by UID.", "operationId": "getDataSourceByUID", "parameters": [ @@ -4712,7 +5060,9 @@ }, "put": { "description": "Similar to creating a data source, `password` and `basicAuthPassword` should be defined under\nsecureJsonData in order to be stored securely as an encrypted blob in the database. Then, the\nencrypted fields are listed under secureJsonFields section in the response.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:write` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:1` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Update an existing data source.", "operationId": "updateDataSourceByUID", "parameters": [ @@ -4748,7 +5098,9 @@ }, "delete": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:kLtEtcRGk` (single data source).", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Delete an existing data source by UID.", "operationId": "deleteDataSourceByUID", "parameters": [ @@ -4780,7 +5132,9 @@ }, "/datasources/uid/{uid}/correlations/{correlationUID}": { "delete": { - "tags": ["correlations"], + "tags": [ + "correlations" + ], "summary": "Delete a correlation.", "operationId": "deleteCorrelation", "parameters": [ @@ -4818,7 +5172,9 @@ }, "/datasources/uid/{uid}/health": { "get": { - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Sends a health check request to the plugin datasource identified by the UID.", "operationId": "checkDatasourceHealthWithUID", "parameters": [ @@ -4850,7 +5206,9 @@ }, "/datasources/uid/{uid}/resources/{datasource_proxy_route}": { "get": { - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Fetch data source resources.", "operationId": "callDatasourceResourceWithUID", "parameters": [ @@ -4892,7 +5250,10 @@ "/datasources/{datasourceId}/disable-permissions": { "post": { "description": "Disables permissions for the data source with the given id. All existing permissions will be removed and anyone will be able to query the data source.\n\nYou need to have a permission with action `datasources.permissions:toggle` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.", - "tags": ["datasource_permissions", "enterprise"], + "tags": [ + "datasource_permissions", + "enterprise" + ], "summary": "Disable permissions for a data source.", "operationId": "disablePermissions", "parameters": [ @@ -4928,7 +5289,10 @@ "/datasources/{datasourceId}/enable-permissions": { "post": { "description": "Enables permissions for the data source with the given id.\nNo one except Org Admins will be able to query the data source until permissions have been added\nwhich permit certain users or teams to query the data source.\n\nYou need to have a permission with action `datasources.permissions:toggle` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.", - "tags": ["datasource_permissions", "enterprise"], + "tags": [ + "datasource_permissions", + "enterprise" + ], "summary": "Enable permissions for a data source.", "operationId": "enablePermissions", "parameters": [ @@ -4964,7 +5328,10 @@ "/datasources/{datasourceId}/permissions": { "get": { "description": "Gets all existing permissions for the data source with the given id.\n\nYou need to have a permission with action `datasources.permissions:read` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.\nDeprecated. Please use GET /api/access-control/datasources/:uid", - "tags": ["datasource_permissions", "enterprise"], + "tags": [ + "datasource_permissions", + "enterprise" + ], "summary": "Get permissions for a data source.", "operationId": "getAllPermissions", "parameters": [ @@ -4995,7 +5362,10 @@ }, "post": { "description": "You need to have a permission with action `datasources.permissions:read` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.\nDeprecated. Please use POST /api/access-control/datasources/:uid/users/:id, /api/access-control/datasources/:uid/teams/:id or /api/access-control/datasources/:uid/buildInRoles/:id", - "tags": ["datasource_permissions", "enterprise"], + "tags": [ + "datasource_permissions", + "enterprise" + ], "summary": "Add permissions for a data source.", "operationId": "addPermission", "parameters": [ @@ -5051,7 +5421,10 @@ "/datasources/{datasourceId}/permissions/{permissionId}": { "delete": { "description": "Removes the permission with the given permissionId for the data source with the given id.\n\nYou need to have a permission with action `datasources.permissions:delete` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.\nDeprecated. Please use POST /api/access-control/datasources/:uid/users/:id, /api/access-control/datasources/:uid/teams/:id or /api/access-control/datasources/:uid/buildInRoles/:id", - "tags": ["datasource_permissions", "enterprise"], + "tags": [ + "datasource_permissions", + "enterprise" + ], "summary": "Remove permission for a data source.", "operationId": "deletePermissions", "parameters": [ @@ -5087,7 +5460,9 @@ "/datasources/{id}": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).\n\nPlease refer to [updated API](#/datasources/getDataSourceByUID) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Get a single data source by Id.", "operationId": "getDataSourceByID", "deprecated": true, @@ -5122,7 +5497,9 @@ }, "put": { "description": "Similar to creating a data source, `password` and `basicAuthPassword` should be defined under\nsecureJsonData in order to be stored securely as an encrypted blob in the database. Then, the\nencrypted fields are listed under secureJsonFields section in the response.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:write` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).\n\nPlease refer to [updated API](#/datasources/updateDataSourceByUID) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Update an existing data source by its sequential ID.", "operationId": "updateDataSourceByID", "deprecated": true, @@ -5159,7 +5536,9 @@ }, "delete": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:delete` and scopes: `datasources:*`, `datasources:id:*` and `datasources:id:1` (single data source).\n\nPlease refer to [updated API](#/datasources/deleteDataSourceByUID) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Delete an existing data source by id.", "operationId": "deleteDataSourceByID", "deprecated": true, @@ -5193,7 +5572,9 @@ "/datasources/{id}/health": { "get": { "description": "Please refer to [updated API](#/datasources/checkDatasourceHealthWithUID) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Sends a health check request to the plugin datasource identified by the ID.", "operationId": "checkDatasourceHealthByID", "deprecated": true, @@ -5227,7 +5608,9 @@ "/datasources/{id}/resources/{datasource_proxy_route}": { "get": { "description": "Please refer to [updated API](#/datasources/callDatasourceResourceWithUID) instead", - "tags": ["datasources"], + "tags": [ + "datasources" + ], "summary": "Fetch data source resources by Id.", "operationId": "callDatasourceResourceByID", "deprecated": true, @@ -5270,7 +5653,9 @@ "/ds/query": { "post": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:query`.", - "tags": ["ds"], + "tags": [ + "ds" + ], "summary": "DataSource query metrics with expressions.", "operationId": "queryMetricsWithExpressions", "parameters": [ @@ -5308,7 +5693,9 @@ "/folders": { "get": { "description": "Returns all folders that the authenticated user has permission to view.\nIf nested folders are enabled, it expects an additional query parameter with the parent folder UID\nand returns the immediate subfolders that the authenticated user has permission to view.\nIf the parameter is not supplied then it returns immediate subfolders under the root\nthat the authenticated user has permission to view.", - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Get all folders.", "operationId": "getFolders", "parameters": [ @@ -5352,7 +5739,9 @@ }, "post": { "description": "If nested folders are enabled then it additionally expects the parent folder UID.", - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Create folder.", "operationId": "createFolder", "parameters": [ @@ -5390,7 +5779,9 @@ "/folders/id/{folder_id}": { "get": { "description": "Returns the folder identified by id. This is deprecated.\nPlease refer to [updated API](#/folders/getFolderByUID) instead", - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Get folder by id.", "operationId": "getFolderByID", "deprecated": true, @@ -5424,7 +5815,9 @@ }, "/folders/{folder_uid}": { "get": { - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Get folder by uid.", "operationId": "getFolderByUID", "parameters": [ @@ -5454,7 +5847,9 @@ } }, "put": { - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Update folder.", "operationId": "updateFolder", "parameters": [ @@ -5500,7 +5895,9 @@ }, "delete": { "description": "Deletes an existing folder identified by UID along with all dashboards (and their alerts) stored in the folder. This operation cannot be reverted.\nIf nested folders are enabled then it also deletes all the subfolders.", - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Delete folder.", "operationId": "deleteFolder", "parameters": [ @@ -5542,7 +5939,9 @@ }, "/folders/{folder_uid}/counts": { "get": { - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Gets the count of each descendant of a folder by kind. The folder is identified by UID.", "operationId": "getFolderDescendantCounts", "parameters": [ @@ -5574,7 +5973,9 @@ }, "/folders/{folder_uid}/move": { "post": { - "tags": ["folders"], + "tags": [ + "folders" + ], "summary": "Move folder.", "operationId": "moveFolder", "parameters": [ @@ -5614,7 +6015,9 @@ }, "/folders/{folder_uid}/permissions": { "get": { - "tags": ["folder_permissions"], + "tags": [ + "folder_permissions" + ], "summary": "Gets all existing permissions for the folder with the given `uid`.", "operationId": "getFolderPermissionList", "parameters": [ @@ -5644,7 +6047,9 @@ } }, "post": { - "tags": ["folder_permissions"], + "tags": [ + "folder_permissions" + ], "summary": "Updates permissions for a folder. This operation will remove existing permissions if they’re not included in the request.", "operationId": "updateFolderPermissions", "parameters": [ @@ -5685,7 +6090,9 @@ "/library-elements": { "get": { "description": "Returns a list of all library elements the authenticated user has permission to view.\nUse the `perPage` query parameter to control the maximum number of library elements returned; the default limit is `100`.\nYou can also use the `page` query parameter to fetch library elements from any page other than the first one.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Get all library elements.", "operationId": "getLibraryElements", "parameters": [ @@ -5696,7 +6103,10 @@ "in": "query" }, { - "enum": [1, 2], + "enum": [ + 1, + 2 + ], "type": "integer", "format": "int64", "description": "Kind of element to search for.", @@ -5704,7 +6114,10 @@ "in": "query" }, { - "enum": ["alpha-asc", "alpha-desc"], + "enum": [ + "alpha-asc", + "alpha-desc" + ], "type": "string", "description": "Sort order of elements.", "name": "sortDirection", @@ -5759,7 +6172,9 @@ }, "post": { "description": "Creates a new library element.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Create library element.", "operationId": "createLibraryElement", "parameters": [ @@ -5797,7 +6212,9 @@ "/library-elements/name/{library_element_name}": { "get": { "description": "Returns a library element with the given name.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Get library element by name.", "operationId": "getLibraryElementByName", "parameters": [ @@ -5827,7 +6244,9 @@ "/library-elements/{library_element_uid}": { "get": { "description": "Returns a library element with the given UID.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Get library element by UID.", "operationId": "getLibraryElementByUID", "parameters": [ @@ -5858,7 +6277,9 @@ }, "delete": { "description": "Deletes an existing library element as specified by the UID. This operation cannot be reverted.\nYou cannot delete a library element that is connected. This operation cannot be reverted.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Delete library element.", "operationId": "deleteLibraryElementByUID", "parameters": [ @@ -5892,7 +6313,9 @@ }, "patch": { "description": "Updates an existing library element identified by uid.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Update library element.", "operationId": "updateLibraryElement", "parameters": [ @@ -5939,7 +6362,9 @@ "/library-elements/{library_element_uid}/connections/": { "get": { "description": "Returns a list of connections for a library element based on the UID specified.", - "tags": ["library_elements"], + "tags": [ + "library_elements" + ], "summary": "Get library element connections.", "operationId": "getLibraryElementConnections", "parameters": [ @@ -5971,7 +6396,10 @@ }, "/licensing/check": { "get": { - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Check license availability.", "operationId": "getStatus", "responses": { @@ -5984,7 +6412,10 @@ "/licensing/custom-permissions": { "get": { "description": "You need to have a permission with action `licensing.reports:read`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Get custom permissions report.", "operationId": "getCustomPermissionsReport", "responses": { @@ -6000,8 +6431,13 @@ "/licensing/custom-permissions-csv": { "get": { "description": "You need to have a permission with action `licensing.reports:read`.", - "produces": ["text/csv"], - "tags": ["licensing", "enterprise"], + "produces": [ + "text/csv" + ], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Get custom permissions report in CSV format.", "operationId": "getCustomPermissionsCSV", "responses": { @@ -6017,7 +6453,10 @@ "/licensing/refresh-stats": { "get": { "description": "You need to have a permission with action `licensing:read`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Refresh license stats.", "operationId": "refreshLicenseStats", "responses": { @@ -6033,7 +6472,10 @@ "/licensing/token": { "get": { "description": "You need to have a permission with action `licensing:read`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Get license token.", "operationId": "getLicenseToken", "responses": { @@ -6044,7 +6486,10 @@ }, "post": { "description": "You need to have a permission with action `licensing:update`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Create license token.", "operationId": "postLicenseToken", "parameters": [ @@ -6068,7 +6513,10 @@ }, "delete": { "description": "Removes the license stored in the Grafana database. Available in Grafana Enterprise v7.4+.\n\nYou need to have a permission with action `licensing:delete`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Remove license from database.", "operationId": "deleteLicenseToken", "parameters": [ @@ -6106,7 +6554,10 @@ "/licensing/token/renew": { "post": { "description": "Manually ask license issuer for a new token. Available in Grafana Enterprise v7.4+.\n\nYou need to have a permission with action `licensing:update`.", - "tags": ["licensing", "enterprise"], + "tags": [ + "licensing", + "enterprise" + ], "summary": "Manually force license refresh.", "operationId": "postRenewLicenseToken", "parameters": [ @@ -6134,7 +6585,10 @@ }, "/logout/saml": { "get": { - "tags": ["saml", "enterprise"], + "tags": [ + "saml", + "enterprise" + ], "summary": "GetLogout initiates single logout process.", "operationId": "getSAMLLogout", "responses": { @@ -6152,7 +6606,9 @@ }, "/org": { "get": { - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Get current Organization.", "operationId": "getCurrentOrg", "responses": { @@ -6171,7 +6627,9 @@ } }, "put": { - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Update current Organization.", "operationId": "updateCurrentOrg", "parameters": [ @@ -6205,7 +6663,9 @@ }, "/org/address": { "put": { - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Update current Organization's address.", "operationId": "updateCurrentOrgAddress", "parameters": [ @@ -6239,7 +6699,9 @@ }, "/org/invites": { "get": { - "tags": ["org_invites"], + "tags": [ + "org_invites" + ], "summary": "Get pending invites.", "operationId": "getPendingOrgInvites", "responses": { @@ -6258,7 +6720,9 @@ } }, "post": { - "tags": ["org_invites"], + "tags": [ + "org_invites" + ], "summary": "Add invite.", "operationId": "addOrgInvite", "parameters": [ @@ -6295,7 +6759,9 @@ }, "/org/invites/{invitation_code}/revoke": { "delete": { - "tags": ["org_invites"], + "tags": [ + "org_invites" + ], "summary": "Revoke invite.", "operationId": "revokeInvite", "parameters": [ @@ -6327,7 +6793,9 @@ }, "/org/preferences": { "get": { - "tags": ["org_preferences"], + "tags": [ + "org_preferences" + ], "summary": "Get Current Org Prefs.", "operationId": "getOrgPreferences", "responses": { @@ -6346,7 +6814,9 @@ } }, "put": { - "tags": ["org_preferences"], + "tags": [ + "org_preferences" + ], "summary": "Update Current Org Prefs.", "operationId": "updateOrgPreferences", "parameters": [ @@ -6378,7 +6848,9 @@ } }, "patch": { - "tags": ["org_preferences"], + "tags": [ + "org_preferences" + ], "summary": "Patch Current Org Prefs.", "operationId": "patchOrgPreferences", "parameters": [ @@ -6413,7 +6885,9 @@ "/org/quotas": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `orgs.quotas:read` and scope `org:id:1` (orgIDScope).", - "tags": ["getCurrentOrg"], + "tags": [ + "getCurrentOrg" + ], "summary": "Fetch Organization quota.", "operationId": "getCurrentOrgQuota", "responses": { @@ -6438,7 +6912,9 @@ "/org/users": { "get": { "description": "Returns all org users within the current organization. Accessible to users with org admin role.\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:read` with scope `users:*`.", - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Get all users within the current organization.", "operationId": "getOrgUsersForCurrentOrg", "responses": { @@ -6458,7 +6934,9 @@ }, "post": { "description": "Adds a global user to the current organization.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:add` with scope `users:*`.", - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Add a new user to the current organization.", "operationId": "addOrgUserToCurrentOrg", "parameters": [ @@ -6490,7 +6968,9 @@ "/org/users/lookup": { "get": { "description": "Returns all org users within the current organization, but with less detailed information.\nAccessible to users with org admin role, admin in any folder or admin of any team.\nMainly used by Grafana UI for providing list of users when adding team members and when editing folder/dashboard permissions.", - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Get all users within the current organization (lookup)", "operationId": "getOrgUsersForCurrentOrgLookup", "parameters": [ @@ -6525,7 +7005,9 @@ "/org/users/{user_id}": { "delete": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:remove` with scope `users:*`.", - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Delete user in current organization.", "operationId": "removeOrgUserForCurrentOrg", "parameters": [ @@ -6557,7 +7039,9 @@ }, "patch": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users.role:update` with scope `users:*`.", - "tags": ["org"], + "tags": [ + "org" + ], "summary": "Updates the given user.", "operationId": "updateOrgUserForCurrentOrg", "parameters": [ @@ -6603,7 +7087,9 @@ "basic": [] } ], - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Search all Organizations.", "operationId": "searchOrgs", "parameters": [ @@ -6654,7 +7140,9 @@ }, "post": { "description": "Only works if [users.allow_org_create](https://grafana.com/docs/grafana/latest/administration/configuration/#allow_org_create) is set.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Create Organization.", "operationId": "createOrg", "parameters": [ @@ -6693,7 +7181,9 @@ "basic": [] } ], - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Get Organization by ID.", "operationId": "getOrgByName", "parameters": [ @@ -6727,7 +7217,9 @@ "basic": [] } ], - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Get Organization by ID.", "operationId": "getOrgByID", "parameters": [ @@ -6760,7 +7252,9 @@ "basic": [] } ], - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Update Organization.", "operationId": "updateOrg", "parameters": [ @@ -6804,7 +7298,9 @@ "basic": [] } ], - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Delete Organization.", "operationId": "deleteOrgByID", "parameters": [ @@ -6840,7 +7336,9 @@ }, "/orgs/{org_id}/address": { "put": { - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Update Organization's address.", "operationId": "updateOrgAddress", "parameters": [ @@ -6882,7 +7380,9 @@ "/orgs/{org_id}/quotas": { "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `orgs.quotas:read` and scope `org:id:1` (orgIDScope).", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Fetch Organization quota.", "operationId": "getOrgQuota", "parameters": [ @@ -6921,7 +7421,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled, you need to have a permission with action `orgs.quotas:write` and scope `org:id:1` (orgIDScope).", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Update user quota.", "operationId": "updateOrgQuota", "parameters": [ @@ -6974,7 +7476,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:read` with scope `users:*`.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Get Users in Organization.", "operationId": "getOrgUsers", "parameters": [ @@ -7003,7 +7507,9 @@ }, "post": { "description": "Adds a global user to the current organization.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:add` with scope `users:*`.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Add a new user to the current organization.", "operationId": "addOrgUser", "parameters": [ @@ -7047,7 +7553,9 @@ } ], "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:read` with scope `users:*`.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Search Users in Organization.", "operationId": "searchOrgUsers", "parameters": [ @@ -7078,7 +7586,9 @@ "/orgs/{org_id}/users/{user_id}": { "delete": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:remove` with scope `users:*`.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Delete user in current organization.", "operationId": "removeOrgUser", "parameters": [ @@ -7117,7 +7627,9 @@ }, "patch": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users.role:update` with scope `users:*`.", - "tags": ["orgs"], + "tags": [ + "orgs" + ], "summary": "Update Users in Organization.", "operationId": "updateOrgUser", "parameters": [ @@ -7165,7 +7677,9 @@ }, "/playlists": { "get": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Get playlists.", "operationId": "searchPlaylists", "parameters": [ @@ -7192,7 +7706,9 @@ } }, "post": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Create playlist.", "operationId": "createPlaylist", "parameters": [ @@ -7226,7 +7742,9 @@ }, "/playlists/{uid}": { "get": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Get playlist.", "operationId": "getPlaylist", "parameters": [ @@ -7256,7 +7774,9 @@ } }, "put": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Update playlist.", "operationId": "updatePlaylist", "parameters": [ @@ -7294,7 +7814,9 @@ } }, "delete": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Delete playlist.", "operationId": "deletePlaylist", "parameters": [ @@ -7326,7 +7848,9 @@ }, "/playlists/{uid}/items": { "get": { - "tags": ["playlists"], + "tags": [ + "playlists" + ], "summary": "Get playlist items.", "operationId": "getPlaylistItems", "parameters": [ @@ -7359,7 +7883,9 @@ "/public/dashboards/{accessToken}": { "get": { "description": "Get public dashboard for view", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "viewPublicDashboard", "parameters": [ { @@ -7394,7 +7920,9 @@ "/public/dashboards/{accessToken}/annotations": { "get": { "description": "Get annotations for a public dashboard", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "getPublicAnnotations", "parameters": [ { @@ -7429,7 +7957,9 @@ "/public/dashboards/{accessToken}/panels/{panelId}/query": { "post": { "description": "Get results for a given panel on a public dashboard", - "tags": ["dashboard_public"], + "tags": [ + "dashboard_public" + ], "operationId": "queryPublicDashboard", "parameters": [ { @@ -7471,7 +8001,9 @@ "/query-history": { "get": { "description": "Returns a list of queries in the query history that matches the search criteria.\nQuery history search supports pagination. Use the `limit` parameter to control the maximum number of queries returned; the default limit is 100.\nYou can also use the `page` query parameter to fetch queries from any page other than the first one.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Query history search.", "operationId": "searchQueries", "parameters": [ @@ -7498,7 +8030,10 @@ "in": "query" }, { - "enum": ["time-desc", "time-asc"], + "enum": [ + "time-desc", + "time-asc" + ], "type": "string", "default": "time-desc", "description": "Sort method", @@ -7548,7 +8083,9 @@ }, "post": { "description": "Adds new query to query history.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Add query to query history.", "operationId": "createQuery", "parameters": [ @@ -7580,7 +8117,9 @@ "/query-history/star/{query_history_uid}": { "post": { "description": "Adds star to query in query history as specified by the UID.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Add star to query in query history.", "operationId": "starQuery", "parameters": [ @@ -7605,7 +8144,9 @@ }, "delete": { "description": "Removes star from query in query history as specified by the UID.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Remove star to query in query history.", "operationId": "unstarQuery", "parameters": [ @@ -7632,7 +8173,9 @@ "/query-history/{query_history_uid}": { "delete": { "description": "Deletes an existing query in query history as specified by the UID. This operation cannot be reverted.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Delete query in query history.", "operationId": "deleteQuery", "parameters": [ @@ -7657,7 +8200,9 @@ }, "patch": { "description": "Updates comment for query in query history as specified by the UID.", - "tags": ["query_history"], + "tags": [ + "query_history" + ], "summary": "Update comment for query in query history.", "operationId": "patchQueryComment", "parameters": [ @@ -7694,7 +8239,10 @@ }, "/recording-rules": { "get": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Lists all rules in the database: active or deleted.", "operationId": "listRecordingRules", "responses": { @@ -7716,7 +8264,10 @@ } }, "put": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Update the active status of a rule.", "operationId": "updateRecordingRule", "parameters": [ @@ -7748,7 +8299,10 @@ } }, "post": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Create a recording rule that is then registered and started.", "operationId": "createRecordingRule", "parameters": [ @@ -7782,7 +8336,10 @@ }, "/recording-rules/test": { "post": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Test a recording rule.", "operationId": "testCreateRecordingRule", "parameters": [ @@ -7819,7 +8376,10 @@ }, "/recording-rules/writer": { "get": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Return the prometheus remote write target.", "operationId": "getRecordingRuleWriteTarget", "responses": { @@ -7842,7 +8402,10 @@ }, "post": { "description": "It returns a 422 if there is not an existing prometheus data source configured.", - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Create a remote write target.", "operationId": "createRecordingRuleWriteTarget", "parameters": [ @@ -7877,7 +8440,10 @@ } }, "delete": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Delete the remote write target.", "operationId": "deleteRecordingRuleWriteTarget", "responses": { @@ -7901,7 +8467,10 @@ }, "/recording-rules/{recordingRuleID}": { "delete": { - "tags": ["recording_rules", "enterprise"], + "tags": [ + "recording_rules", + "enterprise" + ], "summary": "Delete removes the rule from the registry and stops it.", "operationId": "deleteRecordingRule", "parameters": [ @@ -7935,7 +8504,10 @@ "/reports": { "get": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports:read` with scope `reports:*`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "List reports.", "operationId": "getReports", "responses": { @@ -7955,7 +8527,10 @@ }, "post": { "description": "Available to org admins only and with a valid license.\n\nYou need to have a permission with action `reports.admin:create`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Create a report.", "operationId": "createReport", "parameters": [ @@ -7993,7 +8568,10 @@ "/reports/email": { "post": { "description": "Generate and send a report. This API waits for the report to be generated before returning. We recommend that you set the client’s timeout to at least 60 seconds. Available to org admins only and with a valid license.\n\nOnly available in Grafana Enterprise v7.0+.\nThis API endpoint is experimental and may be deprecated in a future release. On deprecation, a migration strategy will be provided and the endpoint will remain functional until the next major release of Grafana.\n\nYou need to have a permission with action `reports:send`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Send a report.", "operationId": "sendReport", "parameters": [ @@ -8031,8 +8609,13 @@ "/reports/render/pdf/{dashboardID}": { "get": { "description": "Please refer to [reports enterprise](#/reports/renderReportPDFs) instead. This will be removed in Grafana 10.", - "produces": ["application/pdf"], - "tags": ["reports", "enterprise"], + "produces": [ + "application/pdf" + ], + "tags": [ + "reports", + "enterprise" + ], "summary": "Render report for dashboard.", "operationId": "renderReportPDF", "deprecated": true, @@ -8101,8 +8684,13 @@ "/reports/render/pdfs": { "get": { "description": "Available to all users and with a valid license.", - "produces": ["application/pdf"], - "tags": ["reports", "enterprise"], + "produces": [ + "application/pdf" + ], + "tags": [ + "reports", + "enterprise" + ], "summary": "Render report for multiple dashboards.", "operationId": "renderReportPDFs", "parameters": [ @@ -8141,7 +8729,10 @@ "/reports/settings": { "get": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.settings:read`x.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Get settings.", "operationId": "getReportSettings", "responses": { @@ -8161,7 +8752,10 @@ }, "post": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.settings:write`xx.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Save settings.", "operationId": "saveReportSettings", "parameters": [ @@ -8196,7 +8790,10 @@ "/reports/test-email": { "post": { "description": "Available to org admins only and with a valid license.\n\nYou need to have a permission with action `reports:send`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Send test report via email.", "operationId": "sendTestEmail", "parameters": [ @@ -8234,7 +8831,10 @@ "/reports/{id}": { "get": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports:read` with scope `reports:id:\u003creport ID\u003e`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Get a report.", "operationId": "getReport", "parameters": [ @@ -8269,7 +8869,10 @@ }, "put": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.admin:write` with scope `reports:id:\u003creport ID\u003e`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Update a report.", "operationId": "updateReport", "parameters": [ @@ -8312,7 +8915,10 @@ }, "delete": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.delete` with scope `reports:id:\u003creport ID\u003e`.", - "tags": ["reports", "enterprise"], + "tags": [ + "reports", + "enterprise" + ], "summary": "Delete a report.", "operationId": "deleteReport", "parameters": [ @@ -8348,7 +8954,10 @@ }, "/saml/acs": { "post": { - "tags": ["saml", "enterprise"], + "tags": [ + "saml", + "enterprise" + ], "summary": "It performs Assertion Consumer Service (ACS).", "operationId": "postACS", "parameters": [ @@ -8373,8 +8982,13 @@ }, "/saml/metadata": { "get": { - "produces": ["application/xml;application/samlmetadata+xml"], - "tags": ["saml", "enterprise"], + "produces": [ + "application/xml;application/samlmetadata+xml" + ], + "tags": [ + "saml", + "enterprise" + ], "summary": "It exposes the SP (Grafana's) metadata for the IdP's consumption.", "operationId": "getMetadata", "responses": { @@ -8387,7 +9001,10 @@ "/saml/slo": { "get": { "description": "There might be two possible requests:\n1. Logout response (callback) when Grafana initiates single logout and IdP returns response to logout request.\n2. Logout request when another SP initiates single logout and IdP sends logout request to the Grafana,\nor in case of IdP-initiated logout.", - "tags": ["saml", "enterprise"], + "tags": [ + "saml", + "enterprise" + ], "summary": "It performs Single Logout (SLO) callback.", "operationId": "getSLO", "responses": { @@ -8407,7 +9024,10 @@ }, "post": { "description": "There might be two possible requests:\n1. Logout response (callback) when Grafana initiates single logout and IdP returns response to logout request.\n2. Logout request when another SP initiates single logout and IdP sends logout request to the Grafana,\nor in case of IdP-initiated logout.", - "tags": ["saml", "enterprise"], + "tags": [ + "saml", + "enterprise" + ], "summary": "It performs Single Logout (SLO) callback.", "operationId": "postSLO", "parameters": [ @@ -8440,7 +9060,9 @@ }, "/search": { "get": { - "tags": ["search"], + "tags": [ + "search" + ], "operationId": "search", "parameters": [ { @@ -8460,7 +9082,10 @@ "in": "query" }, { - "enum": ["dash-folder", "dash-db"], + "enum": [ + "dash-folder", + "dash-db" + ], "type": "string", "description": "Type to search for, dash-folder or dash-db", "name": "type", @@ -8525,7 +9150,10 @@ "in": "query" }, { - "enum": ["Edit", "View"], + "enum": [ + "Edit", + "View" + ], "type": "string", "default": "View", "description": "Set to `Edit` to return dashboards/folders that the user can edit", @@ -8533,7 +9161,10 @@ "in": "query" }, { - "enum": ["alpha-asc", "alpha-desc"], + "enum": [ + "alpha-asc", + "alpha-desc" + ], "type": "string", "default": "alpha-asc", "description": "Sort method; for listing all the possible sort methods use the search sorting endpoint.", @@ -8559,7 +9190,9 @@ }, "/search/sorting": { "get": { - "tags": ["search"], + "tags": [ + "search" + ], "summary": "List search sorting options.", "operationId": "listSortOptions", "responses": { @@ -8575,7 +9208,9 @@ "/serviceaccounts": { "post": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:*`\n\nRequires basic authentication and that the authenticated user is a Grafana Admin.", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Create service account", "operationId": "createServiceAccount", "parameters": [ @@ -8609,7 +9244,9 @@ "/serviceaccounts/search": { "get": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:read` scope: `serviceaccounts:*`", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Search service accounts with paging", "operationId": "searchOrgServiceAccountsWithPaging", "parameters": [ @@ -8663,7 +9300,9 @@ "/serviceaccounts/{serviceAccountId}": { "get": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:read` scope: `serviceaccounts:id:1` (single service account)", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Get single serviceaccount by Id", "operationId": "retrieveServiceAccount", "parameters": [ @@ -8698,7 +9337,9 @@ }, "delete": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:delete` scope: `serviceaccounts:id:1` (single service account)", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Delete service account", "operationId": "deleteServiceAccount", "parameters": [ @@ -8730,7 +9371,9 @@ }, "patch": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:id:1` (single service account)", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Update service account", "operationId": "updateServiceAccount", "parameters": [ @@ -8774,7 +9417,9 @@ "/serviceaccounts/{serviceAccountId}/tokens": { "get": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:read` scope: `global:serviceaccounts:id:1` (single service account)\n\nRequires basic authentication and that the authenticated user is a Grafana Admin.", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "Get service account tokens", "operationId": "listTokens", "parameters": [ @@ -8806,7 +9451,9 @@ }, "post": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:id:1` (single service account)", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "CreateNewToken adds a token to a service account", "operationId": "createToken", "parameters": [ @@ -8853,7 +9500,9 @@ "/serviceaccounts/{serviceAccountId}/tokens/{tokenId}": { "delete": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:id:1` (single service account)\n\nRequires basic authentication and that the authenticated user is a Grafana Admin.", - "tags": ["service_accounts"], + "tags": [ + "service_accounts" + ], "summary": "DeleteToken deletes service account tokens", "operationId": "deleteToken", "parameters": [ @@ -8897,7 +9546,9 @@ "/signing-keys/keys": { "get": { "description": "Required permissions\nNone", - "tags": ["signing_keys"], + "tags": [ + "signing_keys" + ], "summary": "Get JSON Web Key Set (JWKS) with all the keys that can be used to verify tokens (public keys)", "operationId": "retrieveJWKS", "responses": { @@ -8912,7 +9563,9 @@ }, "/snapshot/shared-options": { "get": { - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "Get snapshot sharing settings.", "operationId": "getSharingOptions", "responses": { @@ -8928,7 +9581,9 @@ "/snapshots": { "post": { "description": "Snapshot public mode should be enabled or authentication is required.", - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "When creating a snapshot using the API, you have to provide the full dashboard payload including the snapshot data. This endpoint is designed for the Grafana UI.", "operationId": "createDashboardSnapshot", "parameters": [ @@ -8960,7 +9615,9 @@ "/snapshots-delete/{deleteKey}": { "get": { "description": "Snapshot public mode should be enabled or authentication is required.", - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "Delete Snapshot by deleteKey.", "operationId": "deleteDashboardSnapshotByDeleteKey", "parameters": [ @@ -8992,7 +9649,9 @@ }, "/snapshots/{key}": { "get": { - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "Get Snapshot by Key.", "operationId": "getDashboardSnapshot", "parameters": [ @@ -9019,7 +9678,9 @@ } }, "delete": { - "tags": ["snapshots"], + "tags": [ + "snapshots" + ], "summary": "Delete Snapshot by Key.", "operationId": "deleteDashboardSnapshot", "parameters": [ @@ -9048,7 +9709,9 @@ }, "/teams": { "post": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Add Team.", "operationId": "createTeam", "parameters": [ @@ -9082,7 +9745,9 @@ }, "/teams/search": { "get": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Team Search With Paging.", "operationId": "searchTeams", "parameters": [ @@ -9131,7 +9796,10 @@ }, "/teams/{teamId}/groups": { "get": { - "tags": ["sync_team_groups", "enterprise"], + "tags": [ + "sync_team_groups", + "enterprise" + ], "summary": "Get External Groups.", "operationId": "getTeamGroupsApi", "parameters": [ @@ -9165,7 +9833,10 @@ } }, "post": { - "tags": ["sync_team_groups", "enterprise"], + "tags": [ + "sync_team_groups", + "enterprise" + ], "summary": "Add External Group.", "operationId": "addTeamGroupApi", "parameters": [ @@ -9207,7 +9878,10 @@ } }, "delete": { - "tags": ["sync_team_groups", "enterprise"], + "tags": [ + "sync_team_groups", + "enterprise" + ], "summary": "Remove External Group.", "operationId": "removeTeamGroupApiQuery", "parameters": [ @@ -9248,7 +9922,9 @@ }, "/teams/{team_id}": { "get": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Get Team By ID.", "operationId": "getTeamByID", "parameters": [ @@ -9278,7 +9954,9 @@ } }, "put": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Update Team.", "operationId": "updateTeam", "parameters": [ @@ -9319,7 +9997,9 @@ } }, "delete": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Delete Team By ID.", "operationId": "deleteTeamByID", "parameters": [ @@ -9351,7 +10031,9 @@ }, "/teams/{team_id}/members": { "get": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Get Team Members.", "operationId": "getTeamMembers", "parameters": [ @@ -9381,7 +10063,9 @@ } }, "post": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Add Team Member.", "operationId": "addTeamMember", "parameters": [ @@ -9421,7 +10105,9 @@ }, "/teams/{team_id}/members/{user_id}": { "put": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Update Team Member.", "operationId": "updateTeamMember", "parameters": [ @@ -9466,7 +10152,9 @@ } }, "delete": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Remove Member From Team.", "operationId": "removeTeamMember", "parameters": [ @@ -9505,7 +10193,9 @@ }, "/teams/{team_id}/preferences": { "get": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Get Team Preferences.", "operationId": "getTeamPreferences", "parameters": [ @@ -9529,7 +10219,9 @@ } }, "put": { - "tags": ["teams"], + "tags": [ + "teams" + ], "summary": "Update Team Preferences.", "operationId": "updateTeamPreferences", "parameters": [ @@ -9567,7 +10259,9 @@ "/user": { "get": { "description": "Get (current authenticated user)", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "operationId": "getSignedInUser", "responses": { "200": { @@ -9588,7 +10282,9 @@ } }, "put": { - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Update signed in User.", "operationId": "updateSignedInUser", "parameters": [ @@ -9621,7 +10317,9 @@ "/user/auth-tokens": { "get": { "description": "Return a list of all auth tokens (devices) that the actual user currently have logged in from.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Auth tokens of the actual User.", "operationId": "getUserAuthTokens", "responses": { @@ -9642,7 +10340,9 @@ }, "/user/helpflags/clear": { "get": { - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Clear user help flag.", "operationId": "clearHelpFlags", "responses": { @@ -9663,7 +10363,9 @@ }, "/user/helpflags/{flag_id}": { "put": { - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Set user help flag.", "operationId": "setHelpFlag", "parameters": [ @@ -9698,7 +10400,9 @@ } ], "description": "Return a list of all organizations of the current user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Organizations of the actual User.", "operationId": "getSignedInUserOrgList", "responses": { @@ -9725,7 +10429,9 @@ } ], "description": "Changes the password for the user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Change Password.", "operationId": "changeUserPassword", "parameters": [ @@ -9760,7 +10466,9 @@ }, "/user/preferences": { "get": { - "tags": ["user_preferences"], + "tags": [ + "user_preferences" + ], "summary": "Get user preferences.", "operationId": "getUserPreferences", "responses": { @@ -9777,7 +10485,9 @@ }, "put": { "description": "Omitting a key (`theme`, `homeDashboardId`, `timezone`) will cause the current value to be replaced with the system default value.", - "tags": ["user_preferences"], + "tags": [ + "user_preferences" + ], "summary": "Update user preferences.", "operationId": "updateUserPreferences", "parameters": [ @@ -9806,7 +10516,9 @@ } }, "patch": { - "tags": ["user_preferences"], + "tags": [ + "user_preferences" + ], "summary": "Patch user preferences.", "operationId": "patchUserPreferences", "parameters": [ @@ -9837,7 +10549,9 @@ }, "/user/quotas": { "get": { - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Fetch user quota.", "operationId": "getUserQuotas", "responses": { @@ -9862,7 +10576,9 @@ "/user/revoke-auth-token": { "post": { "description": "Revokes the given auth token (device) for the actual user. User of issued auth token (device) will no longer be logged in and will be required to authenticate again upon next activity.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Revoke an auth token of the actual User.", "operationId": "revokeUserAuthToken", "parameters": [ @@ -9897,7 +10613,9 @@ "/user/stars/dashboard/uid/{dashboard_uid}": { "post": { "description": "Stars the given Dashboard for the actual user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Star a dashboard.", "operationId": "starDashboardByUID", "parameters": [ @@ -9928,7 +10646,9 @@ }, "delete": { "description": "Deletes the starring of the given Dashboard for the actual user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Unstar a dashboard.", "operationId": "unstarDashboardByUID", "parameters": [ @@ -9961,7 +10681,9 @@ "/user/stars/dashboard/{dashboard_id}": { "post": { "description": "Stars the given Dashboard for the actual user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Star a dashboard.", "operationId": "starDashboard", "deprecated": true, @@ -9993,7 +10715,9 @@ }, "delete": { "description": "Deletes the starring of the given Dashboard for the actual user.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Unstar a dashboard.", "operationId": "unstarDashboard", "deprecated": true, @@ -10027,7 +10751,9 @@ "/user/teams": { "get": { "description": "Return a list of all teams that the current user is member of.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Teams that the actual User is member of.", "operationId": "getSignedInUserTeamList", "responses": { @@ -10049,7 +10775,9 @@ "/user/using/{org_id}": { "post": { "description": "Switch user context to the given organization.", - "tags": ["signed_in_user"], + "tags": [ + "signed_in_user" + ], "summary": "Switch user context for signed in user.", "operationId": "userSetUsingOrg", "parameters": [ @@ -10083,7 +10811,9 @@ "/users": { "get": { "description": "Returns all users that the authenticated user has permission to view, admin permission required.", - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get users.", "operationId": "searchUsers", "parameters": [ @@ -10122,7 +10852,9 @@ }, "/users/lookup": { "get": { - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get user by login or email.", "operationId": "getUserByLoginOrEmail", "parameters": [ @@ -10155,7 +10887,9 @@ }, "/users/search": { "get": { - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get users with paging.", "operationId": "searchUsersWithPaging", "responses": { @@ -10179,7 +10913,9 @@ }, "/users/{user_id}": { "get": { - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get user by id.", "operationId": "getUserByID", "parameters": [ @@ -10211,7 +10947,9 @@ }, "put": { "description": "Update the user identified by id.", - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Update user.", "operationId": "updateUser", "parameters": [ @@ -10254,7 +10992,9 @@ "/users/{user_id}/orgs": { "get": { "description": "Get organizations for user identified by id.", - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get organizations for user.", "operationId": "getUserOrgList", "parameters": [ @@ -10288,7 +11028,9 @@ "/users/{user_id}/teams": { "get": { "description": "Get teams for user identified by id.", - "tags": ["users"], + "tags": [ + "users" + ], "summary": "Get teams for user.", "operationId": "getUserTeams", "parameters": [ @@ -10368,7 +11110,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "secondsToLive": { "type": "integer", @@ -10435,7 +11182,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "sendEmail": { "type": "boolean" @@ -10450,7 +11202,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] } } }, @@ -10685,7 +11442,12 @@ "Alert": { "type": "object", "title": "Alert has info for an alert.", - "required": ["labels", "annotations", "state", "value"], + "required": [ + "labels", + "annotations", + "state", + "value" + ], "properties": { "activeAt": { "type": "string", @@ -10708,7 +11470,9 @@ "AlertDiscovery": { "type": "object", "title": "AlertDiscovery has info for all active alerts.", - "required": ["alerts"], + "required": [ + "alerts" + ], "properties": { "alerts": { "type": "array", @@ -10927,7 +11691,9 @@ }, "AlertResponse": { "type": "object", - "required": ["status"], + "required": [ + "status" + ], "properties": { "data": { "$ref": "#/definitions/AlertDiscovery" @@ -10967,7 +11733,11 @@ }, "execErrState": { "type": "string", - "enum": ["OK", "Alerting", "Error"] + "enum": [ + "OK", + "Alerting", + "Error" + ] }, "for": { "$ref": "#/definitions/Duration" @@ -10983,7 +11753,11 @@ }, "noDataState": { "type": "string", - "enum": ["Alerting", "NoData", "OK"] + "enum": [ + "Alerting", + "NoData", + "OK" + ] }, "panelId": { "type": "integer", @@ -11163,7 +11937,15 @@ "AlertingRule": { "description": "adapted from cortex", "type": "object", - "required": ["name", "query", "health", "type", "state", "annotations", "activeAt"], + "required": [ + "name", + "query", + "health", + "type", + "state", + "annotations", + "activeAt" + ], "properties": { "activeAt": { "type": "string", @@ -11233,7 +12015,11 @@ "properties": { "alertmanagersChoice": { "type": "string", - "enum": ["all", "internal", "external"] + "enum": [ + "all", + "internal", + "external" + ] }, "numExternalAlertmanagers": { "type": "integer", @@ -11416,7 +12202,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] } } }, @@ -11513,7 +12304,11 @@ }, "no_data_state": { "type": "string", - "enum": ["Alerting", "NoData", "OK"] + "enum": [ + "Alerting", + "NoData", + "OK" + ] }, "title": { "type": "string" @@ -12039,7 +12834,11 @@ }, "CorrelationConfig": { "type": "object", - "required": ["field", "type", "target"], + "required": [ + "field", + "type", + "target" + ], "properties": { "field": { "description": "Field used to attach the correlation link", @@ -12189,7 +12988,9 @@ }, "CreateDashboardSnapshotCommand": { "type": "object", - "required": ["dashboard"], + "required": [ + "dashboard" + ], "properties": { "dashboard": { "$ref": "#/definitions/Json" @@ -12254,7 +13055,10 @@ "description": "Kind of element to create, Use 1 for library panels or 2 for c.\nDescription:\n1 - library panels\n2 - library variables", "type": "integer", "format": "int64", - "enum": [1, 2] + "enum": [ + 1, + 2 + ] }, "model": { "description": "The JSON model for the library element.", @@ -12355,7 +13159,9 @@ "CreateQueryInQueryHistoryCommand": { "description": "CreateQueryInQueryHistoryCommand is the command for adding query history", "type": "object", - "required": ["queries"], + "required": [ + "queries" + ], "properties": { "datasourceUid": { "description": "UID of the data source for which are queries stored.", @@ -12416,7 +13222,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "example": "Admin" } } @@ -12511,7 +13322,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "slug": { "type": "string" @@ -12565,7 +13381,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "teamId": { "type": "integer", @@ -13119,7 +13940,9 @@ }, "DiscoveryBase": { "type": "object", - "required": ["status"], + "required": [ + "status" + ], "properties": { "error": { "type": "string" @@ -13214,7 +14037,10 @@ "EmbeddedContactPoint": { "description": "EmbeddedContactPoint is the contact point type that is used\nby grafanas embedded alertmanager implementation.", "type": "object", - "required": ["type", "settings"], + "required": [ + "type", + "settings" + ], "properties": { "disableResolveMessage": { "type": "boolean", @@ -13302,7 +14128,9 @@ }, "ErrorResponseBody": { "type": "object", - "required": ["message"], + "required": [ + "message" + ], "properties": { "error": { "description": "Error An optional detailed description of the actual error. Only included if running in developer mode.", @@ -14079,7 +14907,11 @@ }, "exec_err_state": { "type": "string", - "enum": ["OK", "Alerting", "Error"] + "enum": [ + "OK", + "Alerting", + "Error" + ] }, "id": { "type": "integer", @@ -14101,7 +14933,11 @@ }, "no_data_state": { "type": "string", - "enum": ["Alerting", "NoData", "OK"] + "enum": [ + "Alerting", + "NoData", + "OK" + ] }, "orgId": { "type": "integer", @@ -14162,7 +14998,11 @@ "properties": { "alertmanagersChoice": { "type": "string", - "enum": ["all", "internal", "external"] + "enum": [ + "all", + "internal", + "external" + ] } } }, @@ -14191,7 +15031,12 @@ }, "GettableStatus": { "type": "object", - "required": ["cluster", "config", "uptime", "versionInfo"], + "required": [ + "cluster", + "config", + "uptime", + "versionInfo" + ], "properties": { "cluster": { "$ref": "#/definitions/clusterStatus" @@ -15159,7 +16004,11 @@ }, "MetricRequest": { "type": "object", - "required": ["from", "to", "queries"], + "required": [ + "from", + "to", + "queries" + ], "properties": { "debug": { "type": "boolean" @@ -15767,7 +16616,10 @@ "description": "Kind of element to create, Use 1 for library panels or 2 for c.\nDescription:\n1 - library panels\n2 - library variables", "type": "integer", "format": "int64", - "enum": [1, 2] + "enum": [ + 1, + 2 + ] }, "model": { "description": "The JSON model for the library element.", @@ -15813,11 +16665,17 @@ }, "theme": { "type": "string", - "enum": ["light", "dark"] + "enum": [ + "light", + "dark" + ] }, "timezone": { "type": "string", - "enum": ["utc", "browser"] + "enum": [ + "utc", + "browser" + ] }, "weekStart": { "type": "string" @@ -16024,7 +16882,9 @@ }, "PostAnnotationsCmd": { "type": "object", - "required": ["text"], + "required": [ + "text" + ], "properties": { "dashboardId": { "type": "integer", @@ -16241,7 +17101,9 @@ }, "PostableExtendedRuleNodeExtended": { "type": "object", - "required": ["rule"], + "required": [ + "rule" + ], "properties": { "folderTitle": { "type": "string", @@ -16311,14 +17173,22 @@ }, "exec_err_state": { "type": "string", - "enum": ["OK", "Alerting", "Error"] + "enum": [ + "OK", + "Alerting", + "Error" + ] }, "is_paused": { "type": "boolean" }, "no_data_state": { "type": "string", - "enum": ["Alerting", "NoData", "OK"] + "enum": [ + "Alerting", + "NoData", + "OK" + ] }, "title": { "type": "string" @@ -16333,7 +17203,11 @@ "properties": { "alertmanagersChoice": { "type": "string", - "enum": ["all", "internal", "external"] + "enum": [ + "all", + "internal", + "external" + ] } } }, @@ -16424,7 +17298,10 @@ "conditions": [ { "evaluator": { - "params": [0, 0], + "params": [ + 0, + 0 + ], "type": "gt" }, "operator": { @@ -16462,7 +17339,11 @@ }, "execErrState": { "type": "string", - "enum": ["OK", "Alerting", "Error"] + "enum": [ + "OK", + "Alerting", + "Error" + ] }, "folderUID": { "type": "string", @@ -16490,7 +17371,11 @@ }, "noDataState": { "type": "string", - "enum": ["Alerting", "NoData", "OK"] + "enum": [ + "Alerting", + "NoData", + "OK" + ] }, "orgID": { "type": "integer", @@ -17372,7 +18257,12 @@ "Rule": { "description": "adapted from cortex", "type": "object", - "required": ["name", "query", "health", "type"], + "required": [ + "name", + "query", + "health", + "type" + ], "properties": { "evaluationTime": { "type": "number", @@ -17404,7 +18294,9 @@ }, "RuleDiscovery": { "type": "object", - "required": ["groups"], + "required": [ + "groups" + ], "properties": { "groups": { "type": "array", @@ -17423,7 +18315,12 @@ }, "RuleGroup": { "type": "object", - "required": ["name", "file", "rules", "interval"], + "required": [ + "name", + "file", + "rules", + "interval" + ], "properties": { "evaluationTime": { "type": "number", @@ -17484,7 +18381,9 @@ }, "RuleResponse": { "type": "object", - "required": ["status"], + "required": [ + "status" + ], "properties": { "data": { "$ref": "#/definitions/RuleDiscovery" @@ -18499,7 +19398,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "status": { "$ref": "#/definitions/TempUserStatus" @@ -18635,7 +19539,10 @@ "kind": { "description": "Kind of template error that occurred.", "type": "string", - "enum": ["invalid_template", "execution_error"] + "enum": [ + "invalid_template", + "execution_error" + ] }, "message": { "description": "Error message.", @@ -18923,7 +19830,10 @@ }, "type": { "type": "string", - "enum": ["regex", "logfmt"] + "enum": [ + "regex", + "logfmt" + ] } } }, @@ -19254,7 +20164,12 @@ "properties": { "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] } } }, @@ -19304,11 +20219,18 @@ }, "theme": { "type": "string", - "enum": ["light", "dark", "system"] + "enum": [ + "light", + "dark", + "system" + ] }, "timezone": { "type": "string", - "enum": ["utc", "browser"] + "enum": [ + "utc", + "browser" + ] }, "weekStart": { "type": "string" @@ -19397,7 +20319,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] }, "serviceAccountId": { "type": "integer", @@ -19472,7 +20399,12 @@ }, "role": { "type": "string", - "enum": ["None", "Viewer", "Editor", "Admin"] + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ] } } }, @@ -19793,7 +20725,9 @@ "alert": { "description": "Alert alert", "type": "object", - "required": ["labels"], + "required": [ + "labels" + ], "properties": { "generatorURL": { "description": "generator URL\nFormat: uri", @@ -19807,7 +20741,11 @@ }, "alertGroup": { "type": "object", - "required": ["alerts", "labels", "receiver"], + "required": [ + "alerts", + "labels", + "receiver" + ], "properties": { "alerts": { "description": "alerts", @@ -19834,7 +20772,11 @@ "alertStatus": { "description": "AlertStatus alert status", "type": "object", - "required": ["inhibitedBy", "silencedBy", "state"], + "required": [ + "inhibitedBy", + "silencedBy", + "state" + ], "properties": { "inhibitedBy": { "description": "inhibited by", @@ -19853,14 +20795,18 @@ "state": { "description": "state", "type": "string", - "enum": ["[unprocessed active suppressed]"] + "enum": [ + "[unprocessed active suppressed]" + ] } } }, "alertmanagerConfig": { "description": "AlertmanagerConfig alertmanager config", "type": "object", - "required": ["original"], + "required": [ + "original" + ], "properties": { "original": { "description": "original", @@ -19871,7 +20817,12 @@ "alertmanagerStatus": { "description": "AlertmanagerStatus alertmanager status", "type": "object", - "required": ["cluster", "config", "uptime", "versionInfo"], + "required": [ + "cluster", + "config", + "uptime", + "versionInfo" + ], "properties": { "cluster": { "$ref": "#/definitions/clusterStatus" @@ -19892,7 +20843,9 @@ "clusterStatus": { "description": "ClusterStatus cluster status", "type": "object", - "required": ["status"], + "required": [ + "status" + ], "properties": { "name": { "description": "name", @@ -19908,14 +20861,25 @@ "status": { "description": "status", "type": "string", - "enum": ["[ready settling disabled]"] + "enum": [ + "[ready settling disabled]" + ] } } }, "gettableAlert": { "description": "GettableAlert gettable alert", "type": "object", - "required": ["labels", "annotations", "endsAt", "fingerprint", "receivers", "startsAt", "status", "updatedAt"], + "required": [ + "labels", + "annotations", + "endsAt", + "fingerprint", + "receivers", + "startsAt", + "status", + "updatedAt" + ], "properties": { "annotations": { "$ref": "#/definitions/labelSet" @@ -19967,7 +20931,16 @@ }, "gettableSilence": { "type": "object", - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt", "id", "status", "updatedAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt", + "id", + "status", + "updatedAt" + ], "properties": { "comment": { "description": "comment", @@ -20012,7 +20985,10 @@ }, "integration": { "type": "object", - "required": ["name", "sendResolved"], + "required": [ + "name", + "sendResolved" + ], "properties": { "lastNotifyAttempt": { "description": "A timestamp indicating the last attempt to deliver a notification regardless of the outcome.\nFormat: date-time", @@ -20047,7 +21023,11 @@ "matcher": { "description": "Matcher matcher", "type": "object", - "required": ["isRegex", "name", "value"], + "required": [ + "isRegex", + "name", + "value" + ], "properties": { "isEqual": { "description": "is equal", @@ -20085,7 +21065,10 @@ "peerStatus": { "description": "PeerStatus peer status", "type": "object", - "required": ["address", "name"], + "required": [ + "address", + "name" + ], "properties": { "address": { "description": "address", @@ -20109,7 +21092,9 @@ "postableAlert": { "description": "PostableAlert postable alert", "type": "object", - "required": ["labels"], + "required": [ + "labels" + ], "properties": { "annotations": { "$ref": "#/definitions/labelSet" @@ -20144,7 +21129,13 @@ "postableSilence": { "description": "PostableSilence postable silence", "type": "object", - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt" + ], "properties": { "comment": { "description": "comment", @@ -20176,7 +21167,10 @@ "publicError": { "description": "PublicError is derived from Error and only contains information\navailable to the end user.", "type": "object", - "required": ["statusCode", "messageId"], + "required": [ + "statusCode", + "messageId" + ], "properties": { "extra": { "description": "Extra Additional information about the error", @@ -20201,7 +21195,11 @@ "receiver": { "description": "Receiver receiver", "type": "object", - "required": ["active", "integrations", "name"], + "required": [ + "active", + "integrations", + "name" + ], "properties": { "active": { "description": "active", @@ -20223,7 +21221,13 @@ "silence": { "description": "Silence silence", "type": "object", - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt" + ], "properties": { "comment": { "description": "comment", @@ -20251,19 +21255,30 @@ "silenceStatus": { "description": "SilenceStatus silence status", "type": "object", - "required": ["state"], + "required": [ + "state" + ], "properties": { "state": { "description": "state", "type": "string", - "enum": ["[expired active pending]"] + "enum": [ + "[expired active pending]" + ] } } }, "versionInfo": { "description": "VersionInfo version info", "type": "object", - "required": ["branch", "buildDate", "buildUser", "goVersion", "revision", "version"], + "required": [ + "branch", + "buildDate", + "buildUser", + "goVersion", + "revision", + "version" + ], "properties": { "branch": { "description": "branch", @@ -20443,7 +21458,12 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "name", "message", "datasource"], + "required": [ + "id", + "name", + "message", + "datasource" + ], "properties": { "datasource": { "$ref": "#/definitions/DataSource" @@ -20471,7 +21491,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["orgId", "message"], + "required": [ + "orgId", + "message" + ], "properties": { "message": { "description": "Message Message of the created org.", @@ -20572,7 +21595,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "properties": { "id": { "description": "ID Identifier of the deleted notification channel.", @@ -20597,7 +21623,11 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "title", "message"], + "required": [ + "id", + "title", + "message" + ], "properties": { "id": { "description": "ID Identifier of the deleted dashboard.", @@ -20622,7 +21652,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "properties": { "id": { "description": "ID Identifier of the deleted data source.", @@ -20642,7 +21675,11 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "title", "message"], + "required": [ + "id", + "title", + "message" + ], "properties": { "id": { "description": "ID Identifier of the deleted folder.", @@ -20850,7 +21887,9 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id"], + "required": [ + "id" + ], "properties": { "id": { "description": "ID Identifier of the data source.", @@ -21303,7 +22342,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["alertId", "message"], + "required": [ + "alertId", + "message" + ], "properties": { "alertId": { "type": "integer", @@ -21323,7 +22365,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["alertsAffected", "message"], + "required": [ + "alertsAffected", + "message" + ], "properties": { "alertsAffected": { "description": "AlertsAffected is the number of the affected alerts.", @@ -21350,7 +22395,10 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "properties": { "id": { "description": "ID Identifier of the created annotation.", @@ -21369,7 +22417,14 @@ "description": "(empty)", "schema": { "type": "object", - "required": ["status", "title", "version", "id", "uid", "url"], + "required": [ + "status", + "title", + "version", + "id", + "uid", + "url" + ], "properties": { "folderUid": { "description": "FolderUID The unique identifier (uid) of the folder the dashboard belongs to.", diff --git a/public/openapi3.json b/public/openapi3.json index e43b98ddb88..6683d7cddd5 100644 --- a/public/openapi3.json +++ b/public/openapi3.json @@ -236,7 +236,12 @@ "type": "string" } }, - "required": ["id", "name", "message", "datasource"], + "required": [ + "id", + "name", + "message", + "datasource" + ], "type": "object" } } @@ -260,7 +265,10 @@ "type": "integer" } }, - "required": ["orgId", "message"], + "required": [ + "orgId", + "message" + ], "type": "object" } } @@ -404,7 +412,10 @@ "type": "string" } }, - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "type": "object" } } @@ -443,7 +454,11 @@ "type": "string" } }, - "required": ["id", "title", "message"], + "required": [ + "id", + "title", + "message" + ], "type": "object" } } @@ -467,7 +482,10 @@ "type": "string" } }, - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "type": "object" } } @@ -496,7 +514,11 @@ "type": "string" } }, - "required": ["id", "title", "message"], + "required": [ + "id", + "title", + "message" + ], "type": "object" } } @@ -794,7 +816,9 @@ "type": "integer" } }, - "required": ["id"], + "required": [ + "id" + ], "type": "object" } } @@ -1476,7 +1500,10 @@ "type": "string" } }, - "required": ["alertId", "message"], + "required": [ + "alertId", + "message" + ], "type": "object" } } @@ -1501,7 +1528,10 @@ "type": "string" } }, - "required": ["alertsAffected", "message"], + "required": [ + "alertsAffected", + "message" + ], "type": "object" } } @@ -1534,7 +1564,10 @@ "type": "string" } }, - "required": ["id", "message"], + "required": [ + "id", + "message" + ], "type": "object" } } @@ -1583,7 +1616,14 @@ "type": "integer" } }, - "required": ["status", "title", "version", "id", "uid", "url"], + "required": [ + "status", + "title", + "version", + "id", + "uid", + "url" + ], "type": "object" } } @@ -1992,7 +2032,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "secondsToLive": { @@ -2059,7 +2104,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "sendEmail": { @@ -2074,7 +2124,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" } }, @@ -2327,7 +2382,12 @@ "type": "string" } }, - "required": ["labels", "annotations", "state", "value"], + "required": [ + "labels", + "annotations", + "state", + "value" + ], "title": "Alert has info for an alert.", "type": "object" }, @@ -2340,7 +2400,9 @@ "type": "array" } }, - "required": ["alerts"], + "required": [ + "alerts" + ], "title": "AlertDiscovery has info for all active alerts.", "type": "object" }, @@ -2566,7 +2628,9 @@ "type": "string" } }, - "required": ["status"], + "required": [ + "status" + ], "type": "object" }, "AlertRuleExport": { @@ -2590,7 +2654,11 @@ "type": "array" }, "execErrState": { - "enum": ["OK", "Alerting", "Error"], + "enum": [ + "OK", + "Alerting", + "Error" + ], "type": "string" }, "for": { @@ -2606,7 +2674,11 @@ "type": "object" }, "noDataState": { - "enum": ["Alerting", "NoData", "OK"], + "enum": [ + "Alerting", + "NoData", + "OK" + ], "type": "string" }, "panelId": { @@ -2851,13 +2923,25 @@ "$ref": "#/components/schemas/RuleType" } }, - "required": ["name", "query", "health", "type", "state", "annotations", "activeAt"], + "required": [ + "name", + "query", + "health", + "type", + "state", + "annotations", + "activeAt" + ], "type": "object" }, "AlertingStatus": { "properties": { "alertmanagersChoice": { - "enum": ["all", "internal", "external"], + "enum": [ + "all", + "internal", + "external" + ], "type": "string" }, "numExternalAlertmanagers": { @@ -3040,7 +3124,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" } }, @@ -3137,7 +3226,11 @@ "type": "object" }, "no_data_state": { - "enum": ["Alerting", "NoData", "OK"], + "enum": [ + "Alerting", + "NoData", + "OK" + ], "type": "string" }, "title": { @@ -3686,7 +3779,11 @@ "$ref": "#/components/schemas/CorrelationConfigType" } }, - "required": ["field", "type", "target"], + "required": [ + "field", + "type", + "target" + ], "type": "object" }, "CorrelationConfigType": { @@ -3842,7 +3939,9 @@ "type": "string" } }, - "required": ["dashboard"], + "required": [ + "dashboard" + ], "type": "object" }, "CreateFolderCommand": { @@ -3877,7 +3976,10 @@ }, "kind": { "description": "Kind of element to create, Use 1 for library panels or 2 for c.\nDescription:\n1 - library panels\n2 - library variables", - "enum": [1, 2], + "enum": [ + 1, + 2 + ], "format": "int64", "type": "integer" }, @@ -3990,7 +4092,9 @@ "$ref": "#/components/schemas/Json" } }, - "required": ["queries"], + "required": [ + "queries" + ], "type": "object" }, "CreateRoleForm": { @@ -4040,7 +4144,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "example": "Admin", "type": "string" } @@ -4135,7 +4244,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "slug": { @@ -4189,7 +4303,12 @@ "$ref": "#/components/schemas/PermissionType" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "teamId": { @@ -4755,7 +4874,9 @@ "type": "string" } }, - "required": ["status"], + "required": [ + "status" + ], "type": "object" }, "DsAccess": { @@ -4889,7 +5010,10 @@ "type": "string" } }, - "required": ["type", "settings"], + "required": [ + "type", + "settings" + ], "type": "object" }, "EnumFieldConfig": { @@ -4941,7 +5065,9 @@ "type": "string" } }, - "required": ["message"], + "required": [ + "message" + ], "type": "object" }, "ErrorSource": { @@ -5703,7 +5829,11 @@ "type": "array" }, "exec_err_state": { - "enum": ["OK", "Alerting", "Error"], + "enum": [ + "OK", + "Alerting", + "Error" + ], "type": "string" }, "id": { @@ -5725,7 +5855,11 @@ "type": "string" }, "no_data_state": { - "enum": ["Alerting", "NoData", "OK"], + "enum": [ + "Alerting", + "NoData", + "OK" + ], "type": "string" }, "orgId": { @@ -5786,7 +5920,11 @@ "GettableNGalertConfig": { "properties": { "alertmanagersChoice": { - "enum": ["all", "internal", "external"], + "enum": [ + "all", + "internal", + "external" + ], "type": "string" } }, @@ -5832,7 +5970,12 @@ "$ref": "#/components/schemas/versionInfo" } }, - "required": ["cluster", "config", "uptime", "versionInfo"], + "required": [ + "cluster", + "config", + "uptime", + "versionInfo" + ], "type": "object" }, "GettableUserConfig": { @@ -6818,7 +6961,11 @@ "type": "string" } }, - "required": ["from", "to", "queries"], + "required": [ + "from", + "to", + "queries" + ], "type": "object" }, "MoveFolderCommand": { @@ -7389,7 +7536,10 @@ }, "kind": { "description": "Kind of element to create, Use 1 for library panels or 2 for c.\nDescription:\n1 - library panels\n2 - library variables", - "enum": [1, 2], + "enum": [ + 1, + 2 + ], "format": "int64", "type": "integer" }, @@ -7436,11 +7586,17 @@ "$ref": "#/components/schemas/QueryHistoryPreference" }, "theme": { - "enum": ["light", "dark"], + "enum": [ + "light", + "dark" + ], "type": "string" }, "timezone": { - "enum": ["utc", "browser"], + "enum": [ + "utc", + "browser" + ], "type": "string" }, "weekStart": { @@ -7681,7 +7837,9 @@ "type": "integer" } }, - "required": ["text"], + "required": [ + "text" + ], "type": "object" }, "PostGraphiteAnnotationsCmd": { @@ -7882,7 +8040,9 @@ "type": "string" } }, - "required": ["rule"], + "required": [ + "rule" + ], "type": "object" }, "PostableGrafanaReceiver": { @@ -7934,14 +8094,22 @@ "type": "array" }, "exec_err_state": { - "enum": ["OK", "Alerting", "Error"], + "enum": [ + "OK", + "Alerting", + "Error" + ], "type": "string" }, "is_paused": { "type": "boolean" }, "no_data_state": { - "enum": ["Alerting", "NoData", "OK"], + "enum": [ + "Alerting", + "NoData", + "OK" + ], "type": "string" }, "title": { @@ -7956,7 +8124,11 @@ "PostableNGalertConfig": { "properties": { "alertmanagersChoice": { - "enum": ["all", "internal", "external"], + "enum": [ + "all", + "internal", + "external" + ], "type": "string" } }, @@ -8033,7 +8205,10 @@ "conditions": [ { "evaluator": { - "params": [0, 0], + "params": [ + 0, + 0 + ], "type": "gt" }, "operator": { @@ -8074,7 +8249,11 @@ "type": "array" }, "execErrState": { - "enum": ["OK", "Alerting", "Error"], + "enum": [ + "OK", + "Alerting", + "Error" + ], "type": "string" }, "folderUID": { @@ -8102,7 +8281,11 @@ "type": "object" }, "noDataState": { - "enum": ["Alerting", "NoData", "OK"], + "enum": [ + "Alerting", + "NoData", + "OK" + ], "type": "string" }, "orgID": { @@ -9024,7 +9207,12 @@ "$ref": "#/components/schemas/RuleType" } }, - "required": ["name", "query", "health", "type"], + "required": [ + "name", + "query", + "health", + "type" + ], "type": "object" }, "RuleDiscovery": { @@ -9043,7 +9231,9 @@ "type": "object" } }, - "required": ["groups"], + "required": [ + "groups" + ], "type": "object" }, "RuleGroup": { @@ -9081,7 +9271,12 @@ "type": "object" } }, - "required": ["name", "file", "rules", "interval"], + "required": [ + "name", + "file", + "rules", + "interval" + ], "type": "object" }, "RuleGroupConfigResponse": { @@ -9122,7 +9317,9 @@ "type": "string" } }, - "required": ["status"], + "required": [ + "status" + ], "type": "object" }, "RuleType": { @@ -10121,7 +10318,12 @@ "type": "integer" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "status": { @@ -10257,7 +10459,10 @@ "properties": { "kind": { "description": "Kind of template error that occurred.", - "enum": ["invalid_template", "execution_error"], + "enum": [ + "invalid_template", + "execution_error" + ], "type": "string" }, "message": { @@ -10545,7 +10750,10 @@ "type": "string" }, "type": { - "enum": ["regex", "logfmt"], + "enum": [ + "regex", + "logfmt" + ], "type": "string" } }, @@ -10876,7 +11084,12 @@ "UpdateOrgUserCommand": { "properties": { "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" } }, @@ -10926,11 +11139,18 @@ "$ref": "#/components/schemas/QueryHistoryPreference" }, "theme": { - "enum": ["light", "dark", "system"], + "enum": [ + "light", + "dark", + "system" + ], "type": "string" }, "timezone": { - "enum": ["utc", "browser"], + "enum": [ + "utc", + "browser" + ], "type": "string" }, "weekStart": { @@ -11019,7 +11239,12 @@ "type": "string" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" }, "serviceAccountId": { @@ -11094,7 +11319,12 @@ "type": "integer" }, "role": { - "enum": ["None", "Viewer", "Editor", "Admin"], + "enum": [ + "None", + "Viewer", + "Editor", + "Admin" + ], "type": "string" } }, @@ -11426,7 +11656,9 @@ "$ref": "#/components/schemas/labelSet" } }, - "required": ["labels"], + "required": [ + "labels" + ], "type": "object" }, "alertGroup": { @@ -11445,7 +11677,11 @@ "$ref": "#/components/schemas/receiver" } }, - "required": ["alerts", "labels", "receiver"], + "required": [ + "alerts", + "labels", + "receiver" + ], "type": "object" }, "alertGroups": { @@ -11474,11 +11710,17 @@ }, "state": { "description": "state", - "enum": ["[unprocessed active suppressed]"], + "enum": [ + "[unprocessed active suppressed]" + ], "type": "string" } }, - "required": ["inhibitedBy", "silencedBy", "state"], + "required": [ + "inhibitedBy", + "silencedBy", + "state" + ], "type": "object" }, "alertmanagerConfig": { @@ -11489,7 +11731,9 @@ "type": "string" } }, - "required": ["original"], + "required": [ + "original" + ], "type": "object" }, "alertmanagerStatus": { @@ -11510,7 +11754,12 @@ "$ref": "#/components/schemas/versionInfo" } }, - "required": ["cluster", "config", "uptime", "versionInfo"], + "required": [ + "cluster", + "config", + "uptime", + "versionInfo" + ], "type": "object" }, "clusterStatus": { @@ -11529,11 +11778,15 @@ }, "status": { "description": "status", - "enum": ["[ready settling disabled]"], + "enum": [ + "[ready settling disabled]" + ], "type": "string" } }, - "required": ["status"], + "required": [ + "status" + ], "type": "object" }, "gettableAlert": { @@ -11580,7 +11833,16 @@ "type": "string" } }, - "required": ["labels", "annotations", "endsAt", "fingerprint", "receivers", "startsAt", "status", "updatedAt"], + "required": [ + "labels", + "annotations", + "endsAt", + "fingerprint", + "receivers", + "startsAt", + "status", + "updatedAt" + ], "type": "object" }, "gettableAlerts": { @@ -11625,7 +11887,16 @@ "type": "string" } }, - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt", "id", "status", "updatedAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt", + "id", + "status", + "updatedAt" + ], "type": "object" }, "gettableSilences": { @@ -11658,7 +11929,10 @@ "type": "boolean" } }, - "required": ["name", "sendResolved"], + "required": [ + "name", + "sendResolved" + ], "type": "object" }, "labelSet": { @@ -11688,7 +11962,11 @@ "type": "string" } }, - "required": ["isRegex", "name", "value"], + "required": [ + "isRegex", + "name", + "value" + ], "type": "object" }, "matchers": { @@ -11718,7 +11996,10 @@ "type": "string" } }, - "required": ["address", "name"], + "required": [ + "address", + "name" + ], "type": "object" }, "postSilencesOKBody": { @@ -11755,7 +12036,9 @@ "type": "string" } }, - "required": ["labels"], + "required": [ + "labels" + ], "type": "object" }, "postableAlerts": { @@ -11794,7 +12077,13 @@ "type": "string" } }, - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt" + ], "type": "object" }, "publicError": { @@ -11819,7 +12108,10 @@ "type": "integer" } }, - "required": ["statusCode", "messageId"], + "required": [ + "statusCode", + "messageId" + ], "type": "object" }, "receiver": { @@ -11841,7 +12133,11 @@ "type": "string" } }, - "required": ["active", "integrations", "name"], + "required": [ + "active", + "integrations", + "name" + ], "type": "object" }, "silence": { @@ -11869,7 +12165,13 @@ "type": "string" } }, - "required": ["comment", "createdBy", "endsAt", "matchers", "startsAt"], + "required": [ + "comment", + "createdBy", + "endsAt", + "matchers", + "startsAt" + ], "type": "object" }, "silenceStatus": { @@ -11877,11 +12179,15 @@ "properties": { "state": { "description": "state", - "enum": ["[expired active pending]"], + "enum": [ + "[expired active pending]" + ], "type": "string" } }, - "required": ["state"], + "required": [ + "state" + ], "type": "object" }, "versionInfo": { @@ -11912,7 +12218,14 @@ "type": "string" } }, - "required": ["branch", "buildDate", "buildUser", "goVersion", "revision", "version"], + "required": [ + "branch", + "buildDate", + "buildUser", + "goVersion", + "revision", + "version" + ], "type": "object" } }, @@ -11959,7 +12272,9 @@ } }, "summary": "Debug permissions.", - "tags": ["enterprise"] + "tags": [ + "enterprise" + ] } }, "/access-control/roles": { @@ -11987,7 +12302,10 @@ } }, "summary": "Get all roles.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "post": { "description": "Creates a new custom role and maps given permissions to that role. Note that roles with the same prefix as Fixed Roles can’t be created.\n\nYou need to have a permission with action `roles:write` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only create custom roles with the same, or a subset of permissions which the user has.\nFor example, if a user does not have required permissions for creating users, they won’t be able to create a custom role which allows to do that. This is done to prevent escalation of privileges.", @@ -12018,7 +12336,10 @@ } }, "summary": "Create a new custom role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/roles/{roleUID}": { @@ -12064,7 +12385,10 @@ } }, "summary": "Delete a custom role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "get": { "description": "Get a role for the given UID.\n\nYou need to have a permission with action `roles:read` and scope `roles:*`.", @@ -12091,7 +12415,10 @@ } }, "summary": "Get a role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "put": { "description": "You need to have a permission with action `roles:write` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only create custom roles with the same, or a subset of permissions which the user has.", @@ -12135,7 +12462,10 @@ } }, "summary": "Update a custom role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/roles/{roleUID}/assignments": { @@ -12167,7 +12497,10 @@ } }, "summary": "Get role assignments.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "put": { "description": "Set role assignments for the role with the given UID.\n\nYou need to have a permission with action `teams.roles:add` and `teams.roles:remove` and scope `permissions:type:delegate`, and `users.roles:add` and `users.roles:remove` and scope `permissions:type:delegate`.", @@ -12208,7 +12541,10 @@ } }, "summary": "Set role assignments.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/status": { @@ -12230,7 +12566,10 @@ } }, "summary": "Get status.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/teams/{teamId}/roles": { @@ -12263,7 +12602,10 @@ } }, "summary": "Get team roles.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "post": { "description": "You need to have a permission with action `teams.roles:add` and scope `permissions:type:delegate`.", @@ -12308,7 +12650,10 @@ } }, "summary": "Add team role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "put": { "description": "You need to have a permission with action `teams.roles:add` and `teams.roles:remove` and scope `permissions:type:delegate` for each.", @@ -12342,7 +12687,10 @@ } }, "summary": "Update team role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/teams/{teamId}/roles/{roleUID}": { @@ -12386,7 +12734,10 @@ } }, "summary": "Remove team role.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/users/{userId}/roles": { @@ -12419,7 +12770,10 @@ } }, "summary": "List roles assigned to a user.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "post": { "description": "Assign a role to a specific user. For bulk updates consider Set user role assignments.\n\nYou need to have a permission with action `users.roles:add` and scope `permissions:type:delegate`. `permissions:type:delegate` scope ensures that users can only assign roles which have same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to assign a role which will allow to do that. This is done to prevent escalation of privileges.", @@ -12461,7 +12815,10 @@ } }, "summary": "Add a user role assignment.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] }, "put": { "description": "Update the user’s role assignments to match the provided set of UIDs. This will remove any assigned roles that aren’t in the request and add roles that are in the set but are not already assigned to the user.\nIf you want to add or remove a single role, consider using Add a user role assignment or Remove a user role assignment instead.\n\nYou need to have a permission with action `users.roles:add` and `users.roles:remove` and scope `permissions:type:delegate` for each. `permissions:type:delegate` scope ensures that users can only assign or unassign roles which have same, or a subset of permissions which the user has. For example, if a user does not have required permissions for creating users, they won’t be able to assign or unassign a role which will allow to do that. This is done to prevent escalation of privileges.", @@ -12506,7 +12863,10 @@ } }, "summary": "Set user role assignments.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/access-control/users/{userId}/roles/{roleUID}": { @@ -12558,7 +12918,10 @@ } }, "summary": "Remove a user role assignment.", - "tags": ["access_control", "enterprise"] + "tags": [ + "access_control", + "enterprise" + ] } }, "/admin/ldap-sync-status": { @@ -12580,7 +12943,10 @@ } }, "summary": "Returns the current state of the LDAP background sync integration.", - "tags": ["ldap_debug", "enterprise"] + "tags": [ + "ldap_debug", + "enterprise" + ] } }, "/admin/ldap/reload": { @@ -12607,7 +12973,9 @@ } ], "summary": "Reloads the LDAP configuration.", - "tags": ["admin_ldap"] + "tags": [ + "admin_ldap" + ] } }, "/admin/ldap/status": { @@ -12634,7 +13002,9 @@ } ], "summary": "Attempts to connect to all the configured LDAP servers and returns information on whenever they're available or not.", - "tags": ["admin_ldap"] + "tags": [ + "admin_ldap" + ] } }, "/admin/ldap/sync/{user_id}": { @@ -12672,7 +13042,9 @@ } ], "summary": "Enables a single Grafana user to be synchronized against LDAP.", - "tags": ["admin_ldap"] + "tags": [ + "admin_ldap" + ] } }, "/admin/ldap/{user_name}": { @@ -12709,7 +13081,9 @@ } ], "summary": "Finds an user based on a username in LDAP. This helps illustrate how would the particular user be mapped in Grafana when synced.", - "tags": ["admin_ldap"] + "tags": [ + "admin_ldap" + ] } }, "/admin/pause-all-alerts": { @@ -12746,7 +13120,9 @@ } ], "summary": "Pause/unpause all (legacy) alerts.", - "tags": ["admin"] + "tags": [ + "admin" + ] } }, "/admin/provisioning/access-control/reload": { @@ -12764,7 +13140,10 @@ } }, "summary": "You need to have a permission with action `provisioning:reload` with scope `provisioners:accesscontrol`.", - "tags": ["access_control_provisioning", "enterprise"] + "tags": [ + "access_control_provisioning", + "enterprise" + ] } }, "/admin/provisioning/dashboards/reload": { @@ -12791,7 +13170,9 @@ } ], "summary": "Reload dashboard provisioning configurations.", - "tags": ["admin_provisioning"] + "tags": [ + "admin_provisioning" + ] } }, "/admin/provisioning/datasources/reload": { @@ -12818,7 +13199,9 @@ } ], "summary": "Reload datasource provisioning configurations.", - "tags": ["admin_provisioning"] + "tags": [ + "admin_provisioning" + ] } }, "/admin/provisioning/notifications/reload": { @@ -12845,7 +13228,9 @@ } ], "summary": "Reload legacy alert notifier provisioning configurations.", - "tags": ["admin_provisioning"] + "tags": [ + "admin_provisioning" + ] } }, "/admin/provisioning/plugins/reload": { @@ -12872,7 +13257,9 @@ } ], "summary": "Reload plugin provisioning configurations.", - "tags": ["admin_provisioning"] + "tags": [ + "admin_provisioning" + ] } }, "/admin/settings": { @@ -12896,7 +13283,9 @@ } ], "summary": "Fetch settings.", - "tags": ["admin"] + "tags": [ + "admin" + ] } }, "/admin/stats": { @@ -12918,7 +13307,9 @@ } }, "summary": "Fetch Grafana Stats.", - "tags": ["admin"] + "tags": [ + "admin" + ] } }, "/admin/users": { @@ -12962,7 +13353,9 @@ } ], "summary": "Create new user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}": { @@ -13003,7 +13396,9 @@ } ], "summary": "Delete global User.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/auth-tokens": { @@ -13041,7 +13436,9 @@ } ], "summary": "Return a list of all auth tokens (devices) that the user currently have logged in from.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/disable": { @@ -13082,7 +13479,9 @@ } ], "summary": "Disable user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/enable": { @@ -13123,7 +13522,9 @@ } ], "summary": "Enable user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/logout": { @@ -13167,7 +13568,9 @@ } ], "summary": "Logout user revokes all auth tokens (devices) for the user. User of issued auth tokens (devices) will no longer be logged in and will be required to authenticate again upon next activity.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/password": { @@ -13219,7 +13622,9 @@ } ], "summary": "Set password for user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/permissions": { @@ -13266,7 +13671,9 @@ } }, "summary": "Set permissions for user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/quotas": { @@ -13307,7 +13714,9 @@ } ], "summary": "Fetch user quota.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/quotas/{quota_target}": { @@ -13367,7 +13776,9 @@ } ], "summary": "Update user quota.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/admin/users/{user_id}/revoke-auth-token": { @@ -13422,7 +13833,9 @@ } ], "summary": "Revoke auth token for user.", - "tags": ["admin_users"] + "tags": [ + "admin_users" + ] } }, "/alert-notifications": { @@ -13444,7 +13857,9 @@ } }, "summary": "Get all notification channels.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] }, "post": { "description": "You can find the full list of [supported notifiers](https://grafana.com/docs/grafana/latest/alerting/old-alerting/notifications/#list-of-supported-notifiers) on the alert notifiers page.", @@ -13478,7 +13893,9 @@ } }, "summary": "Create notification channel.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] } }, "/alert-notifications/lookup": { @@ -13500,7 +13917,9 @@ } }, "summary": "Get all notification channels (lookup).", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] } }, "/alert-notifications/test": { @@ -13539,7 +13958,9 @@ } }, "summary": "Test notification channel.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] } }, "/alert-notifications/uid/{notification_channel_uid}": { @@ -13574,7 +13995,9 @@ } }, "summary": "Delete alert notification by UID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] }, "get": { "description": "Returns the notification channel given the notification channel UID.", @@ -13607,7 +14030,9 @@ } }, "summary": "Get notification channel by UID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] }, "put": { "description": "Updates an existing notification channel identified by uid.", @@ -13651,7 +14076,9 @@ } }, "summary": "Update notification channel by UID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] } }, "/alert-notifications/{notification_channel_id}": { @@ -13687,7 +14114,9 @@ } }, "summary": "Delete alert notification by ID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] }, "get": { "description": "Returns the notification channel given the notification channel ID.", @@ -13721,7 +14150,9 @@ } }, "summary": "Get notification channel by ID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] }, "put": { "description": "Updates an existing notification channel identified by ID.", @@ -13766,7 +14197,9 @@ } }, "summary": "Update notification channel by ID.", - "tags": ["legacy_alerts_notification_channels"] + "tags": [ + "legacy_alerts_notification_channels" + ] } }, "/alerts": { @@ -13806,7 +14239,15 @@ "in": "query", "name": "state", "schema": { - "enum": ["all", "no_data", "paused", "alerting", "ok", "pending", "unknown"], + "enum": [ + "all", + "no_data", + "paused", + "alerting", + "ok", + "pending", + "unknown" + ], "type": "string" } }, @@ -13862,7 +14303,9 @@ } }, "summary": "Get legacy alerts.", - "tags": ["legacy_alerts"] + "tags": [ + "legacy_alerts" + ] } }, "/alerts/states-for-dashboard": { @@ -13891,7 +14334,9 @@ } }, "summary": "Get alert states for a dashboard.", - "tags": ["legacy_alerts"] + "tags": [ + "legacy_alerts" + ] } }, "/alerts/test": { @@ -13925,7 +14370,9 @@ } }, "summary": "Test alert.", - "tags": ["legacy_alerts"] + "tags": [ + "legacy_alerts" + ] } }, "/alerts/{alert_id}": { @@ -13954,7 +14401,9 @@ } }, "summary": "Get alert by ID.", - "tags": ["legacy_alerts"] + "tags": [ + "legacy_alerts" + ] } }, "/alerts/{alert_id}/pause": { @@ -13999,7 +14448,9 @@ } }, "summary": "Pause/unpause alert by id.", - "tags": ["legacy_alerts"] + "tags": [ + "legacy_alerts" + ] } }, "/annotations": { @@ -14094,7 +14545,10 @@ "in": "query", "name": "type", "schema": { - "enum": ["alert", "annotation"], + "enum": [ + "alert", + "annotation" + ], "type": "string" } }, @@ -14119,7 +14573,9 @@ } }, "summary": "Find Annotations.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] }, "post": { "description": "Creates an annotation in the Grafana database. The dashboardId and panelId fields are optional. If they are not specified then an organization annotation is created and can be queried in any dashboard that adds the Grafana annotations data source. When creating a region annotation include the timeEnd property.\nThe format for `time` and `timeEnd` should be epoch numbers in millisecond resolution.\nThe response for this HTTP request is slightly different in versions prior to v6.4. In prior versions you would also get an endId if you where creating a region. But in 6.4 regions are represented using a single event with time and timeEnd properties.", @@ -14153,7 +14609,9 @@ } }, "summary": "Create Annotation.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] } }, "/annotations/graphite": { @@ -14189,7 +14647,9 @@ } }, "summary": "Create Annotation in Graphite format.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] } }, "/annotations/mass-delete": { @@ -14218,7 +14678,9 @@ } }, "summary": "Delete multiple annotations.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] } }, "/annotations/tags": { @@ -14256,7 +14718,9 @@ } }, "summary": "Find Annotations Tags.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] } }, "/annotations/{annotation_id}": { @@ -14288,7 +14752,9 @@ } }, "summary": "Delete Annotation By ID.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] }, "get": { "operationId": "getAnnotationByID", @@ -14314,7 +14780,9 @@ } }, "summary": "Get Annotation by ID.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] }, "patch": { "description": "Updates one or more properties of an annotation that matches the specified ID.\nThis operation currently supports updating of the `text`, `tags`, `time` and `timeEnd` properties.\nThis is available in Grafana 6.0.0-beta2 and above.", @@ -14358,7 +14826,9 @@ } }, "summary": "Patch Annotation.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] }, "put": { "description": "Updates all properties of an annotation that matches the specified id. To only update certain property, consider using the Patch Annotation operation.", @@ -14402,7 +14872,9 @@ } }, "summary": "Update Annotation.", - "tags": ["annotations"] + "tags": [ + "annotations" + ] } }, "/api/v1/provisioning/alert-rules": { @@ -14421,7 +14893,9 @@ } }, "summary": "Get all the alert rules.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "post": { "operationId": "RoutePostAlertRule", @@ -14467,7 +14941,9 @@ } }, "summary": "Create a new alert rule.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/alert-rules/export": { @@ -14536,7 +15012,9 @@ } }, "summary": "Export all alert rules in provisioning file format.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/alert-rules/{UID}": { @@ -14559,7 +15037,9 @@ } }, "summary": "Delete a specific alert rule by UID.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "get": { "operationId": "RouteGetAlertRule", @@ -14590,7 +15070,9 @@ } }, "summary": "Get a specific alert rule by UID.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutAlertRule", @@ -14645,7 +15127,9 @@ } }, "summary": "Update an existing alert rule.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/alert-rules/{UID}/export": { @@ -14706,7 +15190,9 @@ } }, "summary": "Export an alert rule in provisioning file format.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/contact-points": { @@ -14735,7 +15221,9 @@ } }, "summary": "Get all the contact points.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "post": { "operationId": "RoutePostContactpoints", @@ -14772,7 +15260,9 @@ } }, "summary": "Create a contact point.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/contact-points/export": { @@ -14838,7 +15328,9 @@ } }, "summary": "Export all contact points in provisioning file format.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/contact-points/{UID}": { @@ -14861,7 +15353,9 @@ } }, "summary": "Delete a contact point.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutContactpoint", @@ -14909,7 +15403,9 @@ } }, "summary": "Update an existing contact point.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}": { @@ -14949,7 +15445,9 @@ } }, "summary": "Get a rule group.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutAlertRuleGroup", @@ -15004,7 +15502,9 @@ } }, "summary": "Update the interval of a rule group.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}/export": { @@ -15072,7 +15572,9 @@ } }, "summary": "Export an alert rule group in provisioning file format.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/mute-timings": { @@ -15091,7 +15593,9 @@ } }, "summary": "Get all the mute timings.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "post": { "operationId": "RoutePostMuteTiming", @@ -15128,7 +15632,9 @@ } }, "summary": "Create a new mute timing.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/mute-timings/{name}": { @@ -15151,7 +15657,9 @@ } }, "summary": "Delete a mute timing.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "get": { "operationId": "RouteGetMuteTiming", @@ -15182,7 +15690,9 @@ } }, "summary": "Get a mute timing.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutMuteTiming", @@ -15230,7 +15740,9 @@ } }, "summary": "Replace an existing mute timing.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/policies": { @@ -15249,7 +15761,9 @@ } }, "summary": "Clears the notification policy tree.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "get": { "operationId": "RouteGetPolicyTree", @@ -15266,7 +15780,9 @@ } }, "summary": "Get the notification policy tree.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutPolicyTree", @@ -15304,7 +15820,9 @@ } }, "summary": "Sets the notification policy tree.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/policies/export": { @@ -15333,7 +15851,9 @@ } }, "summary": "Export the notification policy tree in provisioning file format.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/templates": { @@ -15355,7 +15875,9 @@ } }, "summary": "Get all notification templates.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/api/v1/provisioning/templates/{name}": { @@ -15378,7 +15900,9 @@ } }, "summary": "Delete a template.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "get": { "operationId": "RouteGetTemplate", @@ -15409,7 +15933,9 @@ } }, "summary": "Get a notification template.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] }, "put": { "operationId": "RoutePutTemplate", @@ -15457,7 +15983,9 @@ } }, "summary": "Updates an existing notification template.", - "tags": ["provisioning"] + "tags": [ + "provisioning" + ] } }, "/auth/keys": { @@ -15493,7 +16021,9 @@ } }, "summary": "Get auth keys.", - "tags": ["api_keys"] + "tags": [ + "api_keys" + ] }, "post": { "deprecated": true, @@ -15531,7 +16061,9 @@ } }, "summary": "Creates an API key.", - "tags": ["api_keys"] + "tags": [ + "api_keys" + ] } }, "/auth/keys/{id}": { @@ -15568,7 +16100,9 @@ } }, "summary": "Delete API key.", - "tags": ["api_keys"] + "tags": [ + "api_keys" + ] } }, "/dashboard/snapshots": { @@ -15603,7 +16137,9 @@ } }, "summary": "List snapshots.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] } }, "/dashboards/calculate-diff": { @@ -15619,7 +16155,10 @@ }, "diffType": { "description": "The type of diff to return\nDescription:\n`basic`\n`json`", - "enum": ["basic", "json"], + "enum": [ + "basic", + "json" + ], "type": "string" }, "new": { @@ -15648,7 +16187,9 @@ } }, "summary": "Perform diff on two dashboards.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/db": { @@ -15693,7 +16234,9 @@ } }, "summary": "Create / Update dashboard", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/home": { @@ -15711,7 +16254,9 @@ } }, "summary": "Get home dashboard.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/id/{DashboardID}/permissions": { @@ -15748,7 +16293,9 @@ } }, "summary": "Gets all existing permissions for the given dashboard.", - "tags": ["dashboard_permissions"] + "tags": [ + "dashboard_permissions" + ] }, "post": { "deprecated": true, @@ -15797,7 +16344,9 @@ } }, "summary": "Updates permissions for a dashboard.", - "tags": ["dashboard_permissions"] + "tags": [ + "dashboard_permissions" + ] } }, "/dashboards/id/{DashboardID}/restore": { @@ -15845,7 +16394,9 @@ } }, "summary": "Restore a dashboard to a given dashboard version.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/dashboards/id/{DashboardID}/versions": { @@ -15882,7 +16433,9 @@ } }, "summary": "Gets all existing versions for the dashboard.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/dashboards/id/{DashboardID}/versions/{DashboardVersionID}": { @@ -15928,7 +16481,9 @@ } }, "summary": "Get a specific dashboard version.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/dashboards/import": { @@ -15966,7 +16521,9 @@ } }, "summary": "Import dashboard.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/public-dashboards": { @@ -15987,7 +16544,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/dashboards/tags": { @@ -16005,7 +16564,9 @@ } }, "summary": "Get all dashboards tags of an organisation.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/uid/{dashboardUid}/public-dashboards": { @@ -16042,7 +16603,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] }, "post": { "description": "Create public dashboard for a dashboard", @@ -16085,7 +16648,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/dashboards/uid/{dashboardUid}/public-dashboards/{uid}": { @@ -16127,7 +16692,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] }, "patch": { "description": "Update public dashboard for a dashboard", @@ -16178,7 +16745,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/dashboards/uid/{uid}": { @@ -16213,7 +16782,9 @@ } }, "summary": "Delete dashboard by uid.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] }, "get": { "description": "Will return the dashboard given the dashboard unique identifier (uid).", @@ -16246,7 +16817,9 @@ } }, "summary": "Get dashboard by uid.", - "tags": ["dashboards"] + "tags": [ + "dashboards" + ] } }, "/dashboards/uid/{uid}/permissions": { @@ -16280,7 +16853,9 @@ } }, "summary": "Gets all existing permissions for the given dashboard.", - "tags": ["dashboard_permissions"] + "tags": [ + "dashboard_permissions" + ] }, "post": { "description": "This operation will remove existing permissions if they’re not included in the request.", @@ -16327,7 +16902,9 @@ } }, "summary": "Updates permissions for a dashboard.", - "tags": ["dashboard_permissions"] + "tags": [ + "dashboard_permissions" + ] } }, "/dashboards/uid/{uid}/restore": { @@ -16372,7 +16949,9 @@ } }, "summary": "Restore a dashboard to a given dashboard version using UID.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/dashboards/uid/{uid}/versions": { @@ -16426,7 +17005,9 @@ } }, "summary": "Gets all existing versions for the dashboard using UID.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/dashboards/uid/{uid}/versions/{DashboardVersionID}": { @@ -16469,7 +17050,9 @@ } }, "summary": "Get a specific dashboard version using UID.", - "tags": ["dashboard_versions"] + "tags": [ + "dashboard_versions" + ] } }, "/datasources": { @@ -16491,7 +17074,9 @@ } }, "summary": "Get all data sources.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "post": { "description": "By defining `password` and `basicAuthPassword` under secureJsonData property\nGrafana encrypts them securely as an encrypted blob in the database.\nThe response then lists the encrypted fields under secureJsonFields.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:create`", @@ -16525,7 +17110,9 @@ } }, "summary": "Create a data source.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/correlations": { @@ -16580,7 +17167,9 @@ } }, "summary": "Gets all correlations.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] } }, "/datasources/id/{name}": { @@ -16615,7 +17204,9 @@ } }, "summary": "Get data source Id by Name.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/name/{name}": { @@ -16650,7 +17241,9 @@ } }, "summary": "Delete an existing data source by name.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:name:*` and `datasources:name:test_datasource` (single data source).", @@ -16680,7 +17273,9 @@ } }, "summary": "Get a single data source by Name.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/proxy/uid/{uid}/{datasource_proxy_route}": { @@ -16726,7 +17321,9 @@ } }, "summary": "Data source proxy DELETE calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "get": { "description": "Proxies all calls to the actual data source.", @@ -16770,7 +17367,9 @@ } }, "summary": "Data source proxy GET calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "post": { "description": "Proxies all calls to the actual data source. The data source should support POST methods for the specific path and role as defined", @@ -16826,7 +17425,9 @@ } }, "summary": "Data source proxy POST calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/proxy/{id}/{datasource_proxy_route}": { @@ -16873,7 +17474,9 @@ } }, "summary": "Data source proxy DELETE calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "get": { "deprecated": true, @@ -16918,7 +17521,9 @@ } }, "summary": "Data source proxy GET calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "post": { "deprecated": true, @@ -16975,7 +17580,9 @@ } }, "summary": "Data source proxy POST calls.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/uid/{sourceUID}/correlations": { @@ -17006,7 +17613,9 @@ } }, "summary": "Gets all correlations originating from the given data source.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] }, "post": { "operationId": "createCorrelation", @@ -17052,7 +17661,9 @@ } }, "summary": "Add correlation.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] } }, "/datasources/uid/{sourceUID}/correlations/{correlationUID}": { @@ -17091,7 +17702,9 @@ } }, "summary": "Gets a correlation.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] }, "patch": { "operationId": "updateCorrelation", @@ -17144,7 +17757,9 @@ } }, "summary": "Updates a correlation.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] } }, "/datasources/uid/{uid}": { @@ -17179,7 +17794,9 @@ } }, "summary": "Delete an existing data source by UID.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "get": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:read` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:kLtEtcRGk` (single data source).", @@ -17215,7 +17832,9 @@ } }, "summary": "Get a single data source by UID.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "put": { "description": "Similar to creating a data source, `password` and `basicAuthPassword` should be defined under\nsecureJsonData in order to be stored securely as an encrypted blob in the database. Then, the\nencrypted fields are listed under secureJsonFields section in the response.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `datasources:write` and scopes: `datasources:*`, `datasources:uid:*` and `datasources:uid:1` (single data source).", @@ -17256,7 +17875,9 @@ } }, "summary": "Update an existing data source.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/uid/{uid}/correlations/{correlationUID}": { @@ -17298,7 +17919,9 @@ } }, "summary": "Delete a correlation.", - "tags": ["correlations"] + "tags": [ + "correlations" + ] } }, "/datasources/uid/{uid}/health": { @@ -17332,7 +17955,9 @@ } }, "summary": "Sends a health check request to the plugin datasource identified by the UID.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/uid/{uid}/resources/{datasource_proxy_route}": { @@ -17377,7 +18002,9 @@ } }, "summary": "Fetch data source resources.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/{datasourceId}/disable-permissions": { @@ -17415,7 +18042,10 @@ } }, "summary": "Disable permissions for a data source.", - "tags": ["datasource_permissions", "enterprise"] + "tags": [ + "datasource_permissions", + "enterprise" + ] } }, "/datasources/{datasourceId}/enable-permissions": { @@ -17453,7 +18083,10 @@ } }, "summary": "Enable permissions for a data source.", - "tags": ["datasource_permissions", "enterprise"] + "tags": [ + "datasource_permissions", + "enterprise" + ] } }, "/datasources/{datasourceId}/permissions": { @@ -17488,7 +18121,10 @@ } }, "summary": "Get permissions for a data source.", - "tags": ["datasource_permissions", "enterprise"] + "tags": [ + "datasource_permissions", + "enterprise" + ] }, "post": { "description": "You need to have a permission with action `datasources.permissions:read` and scopes `datasources:*`, `datasources:id:*`, `datasources:id:1` (single data source).\n\nDeprecated: true.\nDeprecated. Please use POST /api/access-control/datasources/:uid/users/:id, /api/access-control/datasources/:uid/teams/:id or /api/access-control/datasources/:uid/buildInRoles/:id", @@ -17552,7 +18188,10 @@ } }, "summary": "Add permissions for a data source.", - "tags": ["datasource_permissions", "enterprise"] + "tags": [ + "datasource_permissions", + "enterprise" + ] } }, "/datasources/{datasourceId}/permissions/{permissionId}": { @@ -17592,7 +18231,10 @@ } }, "summary": "Remove permission for a data source.", - "tags": ["datasource_permissions", "enterprise"] + "tags": [ + "datasource_permissions", + "enterprise" + ] } }, "/datasources/{id}": { @@ -17628,7 +18270,9 @@ } }, "summary": "Delete an existing data source by id.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "get": { "deprecated": true, @@ -17665,7 +18309,9 @@ } }, "summary": "Get a single data source by Id.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] }, "put": { "deprecated": true, @@ -17707,7 +18353,9 @@ } }, "summary": "Update an existing data source by its sequential ID.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/{id}/health": { @@ -17743,7 +18391,9 @@ } }, "summary": "Sends a health check request to the plugin datasource identified by the ID.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/datasources/{id}/resources/{datasource_proxy_route}": { @@ -17790,7 +18440,9 @@ } }, "summary": "Fetch data source resources by Id.", - "tags": ["datasources"] + "tags": [ + "datasources" + ] } }, "/ds/query": { @@ -17829,7 +18481,9 @@ } }, "summary": "DataSource query metrics with expressions.", - "tags": ["ds"] + "tags": [ + "ds" + ] } }, "/folders": { @@ -17881,7 +18535,9 @@ } }, "summary": "Get all folders.", - "tags": ["folders"] + "tags": [ + "folders" + ] }, "post": { "description": "If nested folders are enabled then it additionally expects the parent folder UID.", @@ -17918,7 +18574,9 @@ } }, "summary": "Create folder.", - "tags": ["folders"] + "tags": [ + "folders" + ] } }, "/folders/id/{folder_id}": { @@ -17955,7 +18613,9 @@ } }, "summary": "Get folder by id.", - "tags": ["folders"] + "tags": [ + "folders" + ] } }, "/folders/{folder_uid}": { @@ -18002,7 +18662,9 @@ } }, "summary": "Delete folder.", - "tags": ["folders"] + "tags": [ + "folders" + ] }, "get": { "operationId": "getFolderByUID", @@ -18034,7 +18696,9 @@ } }, "summary": "Get folder by uid.", - "tags": ["folders"] + "tags": [ + "folders" + ] }, "put": { "operationId": "updateFolder", @@ -18084,7 +18748,9 @@ } }, "summary": "Update folder.", - "tags": ["folders"] + "tags": [ + "folders" + ] } }, "/folders/{folder_uid}/counts": { @@ -18118,7 +18784,9 @@ } }, "summary": "Gets the count of each descendant of a folder by kind. The folder is identified by UID.", - "tags": ["folders"] + "tags": [ + "folders" + ] } }, "/folders/{folder_uid}/move": { @@ -18163,7 +18831,9 @@ } }, "summary": "Move folder.", - "tags": ["folders"] + "tags": [ + "folders" + ] } }, "/folders/{folder_uid}/permissions": { @@ -18197,7 +18867,9 @@ } }, "summary": "Gets all existing permissions for the folder with the given `uid`.", - "tags": ["folder_permissions"] + "tags": [ + "folder_permissions" + ] }, "post": { "operationId": "updateFolderPermissions", @@ -18240,7 +18912,9 @@ } }, "summary": "Updates permissions for a folder. This operation will remove existing permissions if they’re not included in the request.", - "tags": ["folder_permissions"] + "tags": [ + "folder_permissions" + ] } }, "/library-elements": { @@ -18261,7 +18935,10 @@ "in": "query", "name": "kind", "schema": { - "enum": [1, 2], + "enum": [ + 1, + 2 + ], "format": "int64", "type": "integer" } @@ -18271,7 +18948,10 @@ "in": "query", "name": "sortDirection", "schema": { - "enum": ["alpha-asc", "alpha-desc"], + "enum": [ + "alpha-asc", + "alpha-desc" + ], "type": "string" } }, @@ -18332,7 +19012,9 @@ } }, "summary": "Get all library elements.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] }, "post": { "description": "Creates a new library element.", @@ -18369,7 +19051,9 @@ } }, "summary": "Create library element.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] } }, "/library-elements/name/{library_element_name}": { @@ -18401,7 +19085,9 @@ } }, "summary": "Get library element by name.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] } }, "/library-elements/{library_element_uid}": { @@ -18439,7 +19125,9 @@ } }, "summary": "Delete library element.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] }, "get": { "description": "Returns a library element with the given UID.", @@ -18472,7 +19160,9 @@ } }, "summary": "Get library element by UID.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] }, "patch": { "description": "Updates an existing library element identified by uid.", @@ -18522,7 +19212,9 @@ } }, "summary": "Update library element.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] } }, "/library-elements/{library_element_uid}/connections/": { @@ -18557,7 +19249,9 @@ } }, "summary": "Get library element connections.", - "tags": ["library_elements"] + "tags": [ + "library_elements" + ] } }, "/licensing/check": { @@ -18569,7 +19263,10 @@ } }, "summary": "Check license availability.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/licensing/custom-permissions": { @@ -18585,7 +19282,10 @@ } }, "summary": "Get custom permissions report.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/licensing/custom-permissions-csv": { @@ -18601,7 +19301,10 @@ } }, "summary": "Get custom permissions report in CSV format.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/licensing/refresh-stats": { @@ -18617,7 +19320,10 @@ } }, "summary": "Refresh license stats.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/licensing/token": { @@ -18656,7 +19362,10 @@ } }, "summary": "Remove license from database.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] }, "get": { "description": "You need to have a permission with action `licensing:read`.", @@ -18667,7 +19376,10 @@ } }, "summary": "Get license token.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] }, "post": { "description": "You need to have a permission with action `licensing:update`.", @@ -18692,7 +19404,10 @@ } }, "summary": "Create license token.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/licensing/token/renew": { @@ -18722,7 +19437,10 @@ } }, "summary": "Manually force license refresh.", - "tags": ["licensing", "enterprise"] + "tags": [ + "licensing", + "enterprise" + ] } }, "/logout/saml": { @@ -18740,7 +19458,10 @@ } }, "summary": "GetLogout initiates single logout process.", - "tags": ["saml", "enterprise"] + "tags": [ + "saml", + "enterprise" + ] } }, "/org": { @@ -18761,7 +19482,9 @@ } }, "summary": "Get current Organization.", - "tags": ["org"] + "tags": [ + "org" + ] }, "put": { "operationId": "updateCurrentOrg", @@ -18794,7 +19517,9 @@ } }, "summary": "Update current Organization.", - "tags": ["org"] + "tags": [ + "org" + ] } }, "/org/address": { @@ -18829,7 +19554,9 @@ } }, "summary": "Update current Organization's address.", - "tags": ["org"] + "tags": [ + "org" + ] } }, "/org/invites": { @@ -18850,7 +19577,9 @@ } }, "summary": "Get pending invites.", - "tags": ["org_invites"] + "tags": [ + "org_invites" + ] }, "post": { "operationId": "addOrgInvite", @@ -18886,7 +19615,9 @@ } }, "summary": "Add invite.", - "tags": ["org_invites"] + "tags": [ + "org_invites" + ] } }, "/org/invites/{invitation_code}/revoke": { @@ -18920,7 +19651,9 @@ } }, "summary": "Revoke invite.", - "tags": ["org_invites"] + "tags": [ + "org_invites" + ] } }, "/org/preferences": { @@ -18941,7 +19674,9 @@ } }, "summary": "Get Current Org Prefs.", - "tags": ["org_preferences"] + "tags": [ + "org_preferences" + ] }, "patch": { "operationId": "patchOrgPreferences", @@ -18974,7 +19709,9 @@ } }, "summary": "Patch Current Org Prefs.", - "tags": ["org_preferences"] + "tags": [ + "org_preferences" + ] }, "put": { "operationId": "updateOrgPreferences", @@ -19007,7 +19744,9 @@ } }, "summary": "Update Current Org Prefs.", - "tags": ["org_preferences"] + "tags": [ + "org_preferences" + ] } }, "/org/quotas": { @@ -19032,7 +19771,9 @@ } }, "summary": "Fetch Organization quota.", - "tags": ["getCurrentOrg"] + "tags": [ + "getCurrentOrg" + ] } }, "/org/users": { @@ -19054,7 +19795,9 @@ } }, "summary": "Get all users within the current organization.", - "tags": ["org"] + "tags": [ + "org" + ] }, "post": { "description": "Adds a global user to the current organization.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:add` with scope `users:*`.", @@ -19085,7 +19828,9 @@ } }, "summary": "Add a new user to the current organization.", - "tags": ["org"] + "tags": [ + "org" + ] } }, "/org/users/lookup": { @@ -19124,7 +19869,9 @@ } }, "summary": "Get all users within the current organization (lookup)", - "tags": ["org"] + "tags": [ + "org" + ] } }, "/org/users/{user_id}": { @@ -19160,7 +19907,9 @@ } }, "summary": "Delete user in current organization.", - "tags": ["org"] + "tags": [ + "org" + ] }, "patch": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users.role:update` with scope `users:*`.", @@ -19205,7 +19954,9 @@ } }, "summary": "Updates the given user.", - "tags": ["org"] + "tags": [ + "org" + ] } }, "/orgs": { @@ -19270,7 +20021,9 @@ } ], "summary": "Search all Organizations.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] }, "post": { "description": "Only works if [users.allow_org_create](https://grafana.com/docs/grafana/latest/administration/configuration/#allow_org_create) is set.", @@ -19304,7 +20057,9 @@ } }, "summary": "Create Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/name/{org_name}": { @@ -19340,7 +20095,9 @@ } ], "summary": "Get Organization by ID.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}": { @@ -19383,7 +20140,9 @@ } ], "summary": "Delete Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] }, "get": { "operationId": "getOrgByID", @@ -19418,7 +20177,9 @@ } ], "summary": "Get Organization by ID.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] }, "put": { "operationId": "updateOrg", @@ -19467,7 +20228,9 @@ } ], "summary": "Update Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/address": { @@ -19513,7 +20276,9 @@ } }, "summary": "Update Organization's address.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/quotas": { @@ -19549,7 +20314,9 @@ } }, "summary": "Fetch Organization quota.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/quotas/{quota_target}": { @@ -19609,7 +20376,9 @@ } ], "summary": "Update user quota.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/users": { @@ -19647,7 +20416,9 @@ } ], "summary": "Get Users in Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] }, "post": { "description": "Adds a global user to the current organization.\n\nIf you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users:add` with scope `users:*`.", @@ -19689,7 +20460,9 @@ } }, "summary": "Add a new user to the current organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/users/search": { @@ -19727,7 +20500,9 @@ } ], "summary": "Search Users in Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/orgs/{org_id}/users/{user_id}": { @@ -19772,7 +20547,9 @@ } }, "summary": "Delete user in current organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] }, "patch": { "description": "If you are running Grafana Enterprise and have Fine-grained access control enabled\nyou need to have a permission with action: `org.users.role:update` with scope `users:*`.", @@ -19826,7 +20603,9 @@ } }, "summary": "Update Users in Organization.", - "tags": ["orgs"] + "tags": [ + "orgs" + ] } }, "/playlists": { @@ -19859,7 +20638,9 @@ } }, "summary": "Get playlists.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] }, "post": { "operationId": "createPlaylist", @@ -19892,7 +20673,9 @@ } }, "summary": "Create playlist.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] } }, "/playlists/{uid}": { @@ -19926,7 +20709,9 @@ } }, "summary": "Delete playlist.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] }, "get": { "operationId": "getPlaylist", @@ -19958,7 +20743,9 @@ } }, "summary": "Get playlist.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] }, "put": { "operationId": "updatePlaylist", @@ -20001,7 +20788,9 @@ } }, "summary": "Update playlist.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] } }, "/playlists/{uid}/items": { @@ -20035,7 +20824,9 @@ } }, "summary": "Get playlist items.", - "tags": ["playlists"] + "tags": [ + "playlists" + ] } }, "/public/dashboards/{accessToken}": { @@ -20072,7 +20863,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/public/dashboards/{accessToken}/annotations": { @@ -20109,7 +20902,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/public/dashboards/{accessToken}/panels/{panelId}/query": { @@ -20155,7 +20950,9 @@ "$ref": "#/components/responses/internalServerPublicError" } }, - "tags": ["dashboard_public"] + "tags": [ + "dashboard_public" + ] } }, "/query-history": { @@ -20196,7 +20993,10 @@ "name": "sort", "schema": { "default": "time-desc", - "enum": ["time-desc", "time-asc"], + "enum": [ + "time-desc", + "time-asc" + ], "type": "string" } }, @@ -20249,7 +21049,9 @@ } }, "summary": "Query history search.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] }, "post": { "description": "Adds new query to query history.", @@ -20280,7 +21082,9 @@ } }, "summary": "Add query to query history.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] } }, "/query-history/star/{query_history_uid}": { @@ -20309,7 +21113,9 @@ } }, "summary": "Remove star to query in query history.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] }, "post": { "description": "Adds star to query in query history as specified by the UID.", @@ -20336,7 +21142,9 @@ } }, "summary": "Add star to query in query history.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] } }, "/query-history/{query_history_uid}": { @@ -20365,7 +21173,9 @@ } }, "summary": "Delete query in query history.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] }, "patch": { "description": "Updates comment for query in query history as specified by the UID.", @@ -20406,7 +21216,9 @@ } }, "summary": "Update comment for query in query history.", - "tags": ["query_history"] + "tags": [ + "query_history" + ] } }, "/recording-rules": { @@ -20430,7 +21242,10 @@ } }, "summary": "Lists all rules in the database: active or deleted.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] }, "post": { "operationId": "createRecordingRule", @@ -20463,7 +21278,10 @@ } }, "summary": "Create a recording rule that is then registered and started.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] }, "put": { "operationId": "updateRecordingRule", @@ -20496,7 +21314,10 @@ } }, "summary": "Update the active status of a rule.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] } }, "/recording-rules/test": { @@ -20534,7 +21355,10 @@ } }, "summary": "Test a recording rule.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] } }, "/recording-rules/writer": { @@ -20558,7 +21382,10 @@ } }, "summary": "Delete the remote write target.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] }, "get": { "operationId": "getRecordingRuleWriteTarget", @@ -20580,7 +21407,10 @@ } }, "summary": "Return the prometheus remote write target.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] }, "post": { "description": "It returns a 422 if there is not an existing prometheus data source configured.", @@ -20617,7 +21447,10 @@ } }, "summary": "Create a remote write target.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] } }, "/recording-rules/{recordingRuleID}": { @@ -20652,7 +21485,10 @@ } }, "summary": "Delete removes the rule from the registry and stops it.", - "tags": ["recording_rules", "enterprise"] + "tags": [ + "recording_rules", + "enterprise" + ] } }, "/reports": { @@ -20674,7 +21510,10 @@ } }, "summary": "List reports.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] }, "post": { "description": "Available to org admins only and with a valid license.\n\nYou need to have a permission with action `reports.admin:create`.", @@ -20711,7 +21550,10 @@ } }, "summary": "Create a report.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/email": { @@ -20750,7 +21592,10 @@ } }, "summary": "Send a report.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/render/pdf/{dashboardID}": { @@ -20835,7 +21680,10 @@ } }, "summary": "Render report for dashboard.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/render/pdfs": { @@ -20880,7 +21728,10 @@ } }, "summary": "Render report for multiple dashboards.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/settings": { @@ -20902,7 +21753,10 @@ } }, "summary": "Get settings.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] }, "post": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.settings:write`xx.", @@ -20936,7 +21790,10 @@ } }, "summary": "Save settings.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/test-email": { @@ -20975,7 +21832,10 @@ } }, "summary": "Send test report via email.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/reports/{id}": { @@ -21014,7 +21874,10 @@ } }, "summary": "Delete a report.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] }, "get": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports:read` with scope `reports:id:\u003creport ID\u003e`.", @@ -21051,7 +21914,10 @@ } }, "summary": "Get a report.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] }, "put": { "description": "Available to org admins only and with a valid or expired license.\n\nYou need to have a permission with action `reports.admin:write` with scope `reports:id:\u003creport ID\u003e`.", @@ -21099,7 +21965,10 @@ } }, "summary": "Update a report.", - "tags": ["reports", "enterprise"] + "tags": [ + "reports", + "enterprise" + ] } }, "/saml/acs": { @@ -21126,7 +21995,10 @@ } }, "summary": "It performs Assertion Consumer Service (ACS).", - "tags": ["saml", "enterprise"] + "tags": [ + "saml", + "enterprise" + ] } }, "/saml/metadata": { @@ -21138,7 +22010,10 @@ } }, "summary": "It exposes the SP (Grafana's) metadata for the IdP's consumption.", - "tags": ["saml", "enterprise"] + "tags": [ + "saml", + "enterprise" + ] } }, "/saml/slo": { @@ -21160,7 +22035,10 @@ } }, "summary": "It performs Single Logout (SLO) callback.", - "tags": ["saml", "enterprise"] + "tags": [ + "saml", + "enterprise" + ] }, "post": { "description": "There might be two possible requests:\n1. Logout response (callback) when Grafana initiates single logout and IdP returns response to logout request.\n2. Logout request when another SP initiates single logout and IdP sends logout request to the Grafana,\nor in case of IdP-initiated logout.", @@ -21196,7 +22074,10 @@ } }, "summary": "It performs Single Logout (SLO) callback.", - "tags": ["saml", "enterprise"] + "tags": [ + "saml", + "enterprise" + ] } }, "/search": { @@ -21227,7 +22108,10 @@ "in": "query", "name": "type", "schema": { - "enum": ["dash-folder", "dash-db"], + "enum": [ + "dash-folder", + "dash-db" + ], "type": "string" } }, @@ -21309,7 +22193,10 @@ "name": "permission", "schema": { "default": "View", - "enum": ["Edit", "View"], + "enum": [ + "Edit", + "View" + ], "type": "string" } }, @@ -21319,7 +22206,10 @@ "name": "sort", "schema": { "default": "alpha-asc", - "enum": ["alpha-asc", "alpha-desc"], + "enum": [ + "alpha-asc", + "alpha-desc" + ], "type": "string" } } @@ -21338,7 +22228,9 @@ "$ref": "#/components/responses/internalServerError" } }, - "tags": ["search"] + "tags": [ + "search" + ] } }, "/search/sorting": { @@ -21353,7 +22245,9 @@ } }, "summary": "List search sorting options.", - "tags": ["search"] + "tags": [ + "search" + ] } }, "/serviceaccounts": { @@ -21388,7 +22282,9 @@ } }, "summary": "Create service account", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] } }, "/serviceaccounts/search": { @@ -21452,7 +22348,9 @@ } }, "summary": "Search service accounts with paging", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] } }, "/serviceaccounts/{serviceAccountId}": { @@ -21488,7 +22386,9 @@ } }, "summary": "Delete service account", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] }, "get": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:read` scope: `serviceaccounts:id:1` (single service account)", @@ -21525,7 +22425,9 @@ } }, "summary": "Get single serviceaccount by Id", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] }, "patch": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:id:1` (single service account)", @@ -21572,7 +22474,9 @@ } }, "summary": "Update service account", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] } }, "/serviceaccounts/{serviceAccountId}/tokens": { @@ -21608,7 +22512,9 @@ } }, "summary": "Get service account tokens", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] }, "post": { "description": "Required permissions (See note in the [introduction](https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/#service-account-api) for an explanation):\naction: `serviceaccounts:write` scope: `serviceaccounts:id:1` (single service account)", @@ -21658,7 +22564,9 @@ } }, "summary": "CreateNewToken adds a token to a service account", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] } }, "/serviceaccounts/{serviceAccountId}/tokens/{tokenId}": { @@ -21706,7 +22614,9 @@ } }, "summary": "DeleteToken deletes service account tokens", - "tags": ["service_accounts"] + "tags": [ + "service_accounts" + ] } }, "/signing-keys/keys": { @@ -21722,7 +22632,9 @@ } }, "summary": "Get JSON Web Key Set (JWKS) with all the keys that can be used to verify tokens (public keys)", - "tags": ["signing_keys"] + "tags": [ + "signing_keys" + ] } }, "/snapshot/shared-options": { @@ -21737,7 +22649,9 @@ } }, "summary": "Get snapshot sharing settings.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] } }, "/snapshots": { @@ -21770,7 +22684,9 @@ } }, "summary": "When creating a snapshot using the API, you have to provide the full dashboard payload including the snapshot data. This endpoint is designed for the Grafana UI.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] } }, "/snapshots-delete/{deleteKey}": { @@ -21805,7 +22721,9 @@ } }, "summary": "Delete Snapshot by deleteKey.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] } }, "/snapshots/{key}": { @@ -21836,7 +22754,9 @@ } }, "summary": "Delete Snapshot by Key.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] }, "get": { "operationId": "getDashboardSnapshot", @@ -21865,7 +22785,9 @@ } }, "summary": "Get Snapshot by Key.", - "tags": ["snapshots"] + "tags": [ + "snapshots" + ] } }, "/teams": { @@ -21900,7 +22822,9 @@ } }, "summary": "Add Team.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/teams/search": { @@ -21957,7 +22881,9 @@ } }, "summary": "Team Search With Paging.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/teams/{teamId}/groups": { @@ -22002,7 +22928,10 @@ } }, "summary": "Remove External Group.", - "tags": ["sync_team_groups", "enterprise"] + "tags": [ + "sync_team_groups", + "enterprise" + ] }, "get": { "operationId": "getTeamGroupsApi", @@ -22038,7 +22967,10 @@ } }, "summary": "Get External Groups.", - "tags": ["sync_team_groups", "enterprise"] + "tags": [ + "sync_team_groups", + "enterprise" + ] }, "post": { "operationId": "addTeamGroupApi", @@ -22085,7 +23017,10 @@ } }, "summary": "Add External Group.", - "tags": ["sync_team_groups", "enterprise"] + "tags": [ + "sync_team_groups", + "enterprise" + ] } }, "/teams/{team_id}": { @@ -22119,7 +23054,9 @@ } }, "summary": "Delete Team By ID.", - "tags": ["teams"] + "tags": [ + "teams" + ] }, "get": { "operationId": "getTeamByID", @@ -22151,7 +23088,9 @@ } }, "summary": "Get Team By ID.", - "tags": ["teams"] + "tags": [ + "teams" + ] }, "put": { "operationId": "updateTeam", @@ -22197,7 +23136,9 @@ } }, "summary": "Update Team.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/teams/{team_id}/members": { @@ -22231,7 +23172,9 @@ } }, "summary": "Get Team Members.", - "tags": ["teams"] + "tags": [ + "teams" + ] }, "post": { "operationId": "addTeamMember", @@ -22274,7 +23217,9 @@ } }, "summary": "Add Team Member.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/teams/{team_id}/members/{user_id}": { @@ -22317,7 +23262,9 @@ } }, "summary": "Remove Member From Team.", - "tags": ["teams"] + "tags": [ + "teams" + ] }, "put": { "operationId": "updateTeamMember", @@ -22369,7 +23316,9 @@ } }, "summary": "Update Team Member.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/teams/{team_id}/preferences": { @@ -22397,7 +23346,9 @@ } }, "summary": "Get Team Preferences.", - "tags": ["teams"] + "tags": [ + "teams" + ] }, "put": { "operationId": "updateTeamPreferences", @@ -22437,7 +23388,9 @@ } }, "summary": "Update Team Preferences.", - "tags": ["teams"] + "tags": [ + "teams" + ] } }, "/user": { @@ -22461,7 +23414,9 @@ "$ref": "#/components/responses/internalServerError" } }, - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] }, "put": { "operationId": "updateSignedInUser", @@ -22492,7 +23447,9 @@ } }, "summary": "Update signed in User.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/auth-tokens": { @@ -22514,7 +23471,9 @@ } }, "summary": "Auth tokens of the actual User.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/helpflags/clear": { @@ -22535,7 +23494,9 @@ } }, "summary": "Clear user help flag.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/helpflags/{flag_id}": { @@ -22566,7 +23527,9 @@ } }, "summary": "Set user help flag.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/orgs": { @@ -22593,7 +23556,9 @@ } ], "summary": "Organizations of the actual User.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/password": { @@ -22635,7 +23600,9 @@ } ], "summary": "Change Password.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/preferences": { @@ -22653,7 +23620,9 @@ } }, "summary": "Get user preferences.", - "tags": ["user_preferences"] + "tags": [ + "user_preferences" + ] }, "patch": { "operationId": "patchUserPreferences", @@ -22683,7 +23652,9 @@ } }, "summary": "Patch user preferences.", - "tags": ["user_preferences"] + "tags": [ + "user_preferences" + ] }, "put": { "description": "Omitting a key (`theme`, `homeDashboardId`, `timezone`) will cause the current value to be replaced with the system default value.", @@ -22714,7 +23685,9 @@ } }, "summary": "Update user preferences.", - "tags": ["user_preferences"] + "tags": [ + "user_preferences" + ] } }, "/user/quotas": { @@ -22738,7 +23711,9 @@ } }, "summary": "Fetch user quota.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/revoke-auth-token": { @@ -22774,7 +23749,9 @@ } }, "summary": "Revoke an auth token of the actual User.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/stars/dashboard/uid/{dashboard_uid}": { @@ -22809,7 +23786,9 @@ } }, "summary": "Unstar a dashboard.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] }, "post": { "description": "Stars the given Dashboard for the actual user.", @@ -22842,7 +23821,9 @@ } }, "summary": "Star a dashboard.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/stars/dashboard/{dashboard_id}": { @@ -22878,7 +23859,9 @@ } }, "summary": "Unstar a dashboard.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] }, "post": { "deprecated": true, @@ -22912,7 +23895,9 @@ } }, "summary": "Star a dashboard.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/teams": { @@ -22934,7 +23919,9 @@ } }, "summary": "Teams that the actual User is member of.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/user/using/{org_id}": { @@ -22970,7 +23957,9 @@ } }, "summary": "Switch user context for signed in user.", - "tags": ["signed_in_user"] + "tags": [ + "signed_in_user" + ] } }, "/users": { @@ -23014,7 +24003,9 @@ } }, "summary": "Get users.", - "tags": ["users"] + "tags": [ + "users" + ] } }, "/users/lookup": { @@ -23049,7 +24040,9 @@ } }, "summary": "Get user by login or email.", - "tags": ["users"] + "tags": [ + "users" + ] } }, "/users/search": { @@ -23073,7 +24066,9 @@ } }, "summary": "Get users with paging.", - "tags": ["users"] + "tags": [ + "users" + ] } }, "/users/{user_id}": { @@ -23108,7 +24103,9 @@ } }, "summary": "Get user by id.", - "tags": ["users"] + "tags": [ + "users" + ] }, "put": { "description": "Update the user identified by id.", @@ -23154,7 +24151,9 @@ } }, "summary": "Update user.", - "tags": ["users"] + "tags": [ + "users" + ] } }, "/users/{user_id}/orgs": { @@ -23190,7 +24189,9 @@ } }, "summary": "Get organizations for user.", - "tags": ["users"] + "tags": [ + "users" + ] } }, "/users/{user_id}/teams": { @@ -23226,7 +24227,9 @@ } }, "summary": "Get teams for user.", - "tags": ["users"] + "tags": [ + "users" + ] } } },