--- aliases: - ../../http_api/alerting_provisioning/ canonical: /docs/grafana/latest/developers/http_api/alerting_provisioning/ description: Grafana Alerts HTTP API keywords: - grafana - http - documentation - api - alerting - alerts labels: products: - enterprise - oss title: 'Alerting Provisioning HTTP API ' --- # Alerting provisioning HTTP API The Alerting provisioning API can be used to create, modify, and delete resources relevant to [Grafana Managed alerts]({{< relref "/docs/grafana/latest/alerting/alerting-rules/create-grafana-managed-rule" >}}). And is the one used by our [Grafana Terraform provider](https://registry.terraform.io/providers/grafana/grafana/latest/docs). For managing resources related to [data source-managed alerts]({{< relref "/docs/grafana/latest/alerting/alerting-rules/create-grafana-managed-rule" >}}) including Recording Rules, you can use [Mimir tool](https://grafana.com/docs/mimir/latest/manage/tools/mimirtool/) and [Cortex tool](https://github.com/grafana/cortex-tools#cortextool) respectively. ## Information ### Version 1.1.0 ## Content negotiation ### Consumes - application/json ### Produces - application/json - text/yaml - application/yaml ## All endpoints ### Alert rules | Method | URI | Name | Summary | | ------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | | DELETE | /api/v1/provisioning/alert-rules/:uid | [route delete alert rule](#route-delete-alert-rule) | Delete a specific alert rule by UID. | | GET | /api/v1/provisioning/alert-rules/:uid | [route get alert rule](#route-get-alert-rule) | Get a specific alert rule by UID. | | GET | /api/v1/provisioning/alert-rules/:uid/export | [route get alert rule export](#route-get-alert-rule-export) | Export an alert rule in provisioning file format. | | GET | /api/v1/provisioning/folder/:folderUid/rule-groups/:group | [route get alert rule group](#route-get-alert-rule-group) | Get a rule group. | | GET | /api/v1/provisioning/folder/:folderUid/rule-groups/:group/export | [route get alert rule group export](#route-get-alert-rule-group-export) | Export an alert rule group in provisioning file format. | | GET | /api/v1/provisioning/alert-rules | [route get alert rules](#route-get-alert-rules) | Get all the alert rules. | | GET | /api/v1/provisioning/alert-rules/export | [route get alert rules export](#route-get-alert-rules-export) | Export all alert rules in provisioning file format. | | POST | /api/v1/provisioning/alert-rules | [route post alert rule](#route-post-alert-rule) | Create a new alert rule. | | PUT | /api/v1/provisioning/alert-rules/:uid | [route put alert rule](#route-put-alert-rule) | Update an existing alert rule. | | PUT | /api/v1/provisioning/folder/:folderUid/rule-groups/:group | [route put alert rule group](#route-put-alert-rule-group) | Update the interval of a rule group or modify the rules of the group. | ### Contact points | Method | URI | Name | Summary | | ------ | ------------------------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------ | | DELETE | /api/v1/provisioning/contact-points/:uid | [route delete contactpoints](#route-delete-contactpoints) | Delete a contact point. | | GET | /api/v1/provisioning/contact-points | [route get contactpoints](#route-get-contactpoints) | Get all the contact points. | | GET | /api/v1/provisioning/contact-points/export | [route get contactpoints export](#route-get-contactpoints-export) | Export all contact points in provisioning file format. | | POST | /api/v1/provisioning/contact-points | [route post contactpoints](#route-post-contactpoints) | Create a contact point. | | PUT | /api/v1/provisioning/contact-points/:uid | [route put contactpoint](#route-put-contactpoint) | Update an existing contact point. | ### Notification policies | Method | URI | Name | Summary | | ------ | ------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------- | | DELETE | /api/v1/provisioning/policies | [route reset policy tree](#route-reset-policy-tree) | Clears the notification policy tree. | | GET | /api/v1/provisioning/policies | [route get policy tree](#route-get-policy-tree) | Get the notification policy tree. | | GET | /api/v1/provisioning/policies/export | [route get policy tree export](#route-get-policy-tree-export) | Export the notification policy tree in provisioning file format. | | PUT | /api/v1/provisioning/policies | [route put policy tree](#route-put-policy-tree) | Sets the notification policy tree. | ### Mute timings | Method | URI | Name | Summary | | ------ | --------------------------------------- | ----------------------------------------------------- | -------------------------------- | | DELETE | /api/v1/provisioning/mute-timings/:name | [route delete mute timing](#route-delete-mute-timing) | Delete a mute timing. | | GET | /api/v1/provisioning/mute-timings/:name | [route get mute timing](#route-get-mute-timing) | Get a mute timing. | | GET | /api/v1/provisioning/mute-timings | [route get mute timings](#route-get-mute-timings) | Get all the mute timings. | | POST | /api/v1/provisioning/mute-timings | [route post mute timing](#route-post-mute-timing) | Create a new mute timing. | | PUT | /api/v1/provisioning/mute-timings/:name | [route put mute timing](#route-put-mute-timing) | Replace an existing mute timing. | ### Templates | Method | URI | Name | Summary | | ------ | ------------------------------------ | ----------------------------------------------- | ------------------------------------------ | | DELETE | /api/v1/provisioning/templates/:name | [route delete template](#route-delete-template) | Delete a template. | | GET | /api/v1/provisioning/templates/:name | [route get template](#route-get-template) | Get a notification template. | | GET | /api/v1/provisioning/templates | [route get templates](#route-get-templates) | Get all notification templates. | | PUT | /api/v1/provisioning/templates/:name | [route put template](#route-put-template) | Updates an existing notification template. | ## Paths ### Delete a specific alert rule by UID. (_RouteDeleteAlertRule_) ``` DELETE /api/v1/provisioning/alert-rules/:uid ``` #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ------ | -------- | --------- | :------: | ------- | --------------------------------------------------------- | | UID | `path` | string | `string` | | ✓ | | Alert rule UID | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | ----------------------------------- | ---------- | ---------------------------------------- | :---------: | --------------------------------------------- | | [204](#route-delete-alert-rule-204) | No Content | The alert rule was deleted successfully. | | [schema](#route-delete-alert-rule-204-schema) | #### Responses ##### 204 - The alert rule was deleted successfully. Status: No Content ###### Schema ### Delete a contact point. (_RouteDeleteContactpoints_) ``` DELETE /api/v1/provisioning/contact-points/:uid ``` #### Consumes - application/json #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | ------------------------------------------ | | UID | `path` | string | `string` | | ✓ | | UID is the contact point unique identifier | #### All responses | Code | Status | Description | Has headers | Schema | | -------------------------------------- | ---------- | ------------------------------------------- | :---------: | ------------------------------------------------ | | [204](#route-delete-contactpoints-204) | No Content | The contact point was deleted successfully. | | [schema](#route-delete-contactpoints-204-schema) | #### Responses ##### 204 - The contact point was deleted successfully. Status: No Content ###### Schema ### Delete a mute timing. (_RouteDeleteMuteTiming_) ``` DELETE /api/v1/provisioning/mute-timings/:name ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | ---------------- | | name | `path` | string | `string` | | ✓ | | Mute timing name | #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------------ | ---------- | ----------------------------------------- | :---------: | ---------------------------------------------- | | [204](#route-delete-mute-timing-204) | No Content | The mute timing was deleted successfully. | | [schema](#route-delete-mute-timing-204-schema) | #### Responses ##### 204 - The mute timing was deleted successfully. Status: No Content ###### Schema ### Delete a template. (_RouteDeleteTemplate_) ``` DELETE /api/v1/provisioning/templates/:name ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | ------------- | | name | `path` | string | `string` | | ✓ | | Template Name | #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ---------- | -------------------------------------- | :---------: | ------------------------------------------- | | [204](#route-delete-template-204) | No Content | The template was deleted successfully. | | [schema](#route-delete-template-204-schema) | #### Responses ##### 204 - The template was deleted successfully. Status: No Content ###### Schema ### Get a specific alert rule by UID. (_RouteGetAlertRule_) ``` GET /api/v1/provisioning/alert-rules/:uid ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | -------------- | | UID | `path` | string | `string` | | ✓ | | Alert rule UID | #### All responses | Code | Status | Description | Has headers | Schema | | -------------------------------- | --------- | -------------------- | :---------: | ------------------------------------------ | | [200](#route-get-alert-rule-200) | OK | ProvisionedAlertRule | | [schema](#route-get-alert-rule-200-schema) | | [404](#route-get-alert-rule-404) | Not Found | Not found. | | [schema](#route-get-alert-rule-404-schema) | #### Responses ##### 200 - ProvisionedAlertRule Status: OK ###### Schema [ProvisionedAlertRule](#provisioned-alert-rule) ##### 404 - Not found. Status: Not Found ###### Schema ### Export an alert rule in provisioning file format. (_RouteGetAlertRuleExport_) ``` GET /api/v1/provisioning/alert-rules/:uid/export ``` #### Produces - application/json - application/yaml - text/yaml #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------- | ------- | ------- | -------- | --------- | :------: | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | UID | `path` | string | `string` | | ✓ | | Alert rule UID | | download | `query` | boolean | `bool` | | | | Whether to initiate a download of the file or not. | | format | `query` | string | `string` | | | `"yaml"` | Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence. | #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------------- | --------- | ------------------ | :---------: | ------------------------------------------------- | | [200](#route-get-alert-rule-export-200) | OK | AlertingFileExport | | [schema](#route-get-alert-rule-export-200-schema) | | [404](#route-get-alert-rule-export-404) | Not Found | Not found. | | [schema](#route-get-alert-rule-export-404-schema) | #### Responses ##### 200 - AlertingFileExport Status: OK ###### Schema [AlertingFileExport](#alerting-file-export) ##### 404 - Not found. Status: Not Found ###### Schema ### Get a rule group. (_RouteGetAlertRuleGroup_) ``` GET /api/v1/provisioning/folder/:folderUid/rule-groups/:group ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | --------- | ------ | ------ | -------- | --------- | :------: | ------- | ----------- | | FolderUID | `path` | string | `string` | | ✓ | | | | Group | `path` | string | `string` | | ✓ | | | #### All responses | Code | Status | Description | Has headers | Schema | | -------------------------------------- | --------- | -------------- | :---------: | ------------------------------------------------ | | [200](#route-get-alert-rule-group-200) | OK | AlertRuleGroup | | [schema](#route-get-alert-rule-group-200-schema) | | [404](#route-get-alert-rule-group-404) | Not Found | Not found. | | [schema](#route-get-alert-rule-group-404-schema) | #### Responses ##### 200 - AlertRuleGroup Status: OK ###### Schema [AlertRuleGroup](#alert-rule-group) ##### 404 - Not found. Status: Not Found ###### Schema ### Export an alert rule group in provisioning file format. (_RouteGetAlertRuleGroupExport_) ``` GET /api/v1/provisioning/folder/:folderUid/rule-groups/:group/export ``` #### Produces - application/json - application/yaml - text/yaml #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | --------- | ------- | ------- | -------- | --------- | :------: | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | FolderUID | `path` | string | `string` | | ✓ | | | | Group | `path` | string | `string` | | ✓ | | | | download | `query` | boolean | `bool` | | | | Whether to initiate a download of the file or not. | | format | `query` | string | `string` | | | `"yaml"` | Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence. | #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------------------- | --------- | ------------------ | :---------: | ------------------------------------------------------- | | [200](#route-get-alert-rule-group-export-200) | OK | AlertingFileExport | | [schema](#route-get-alert-rule-group-export-200-schema) | | [404](#route-get-alert-rule-group-export-404) | Not Found | Not found. | | [schema](#route-get-alert-rule-group-export-404-schema) | #### Responses ##### 200 - AlertingFileExport Status: OK ###### Schema [AlertingFileExport](#alerting-file-export) ##### 404 - Not found. Status: Not Found ###### Schema ### Get all the alert rules. (_RouteGetAlertRules_) ``` GET /api/v1/provisioning/alert-rules ``` #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ------ | --------------------- | :---------: | ------------------------------------------- | | [200](#route-get-alert-rules-200) | OK | ProvisionedAlertRules | | [schema](#route-get-alert-rules-200-schema) | #### Responses ##### 200 - ProvisionedAlertRules Status: OK ###### Schema [ProvisionedAlertRules](#provisioned-alert-rules) ### Export all alert rules in provisioning file format. (_RouteGetAlertRulesExport_) ``` GET /api/v1/provisioning/alert-rules/export ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------- | ------- | ------- | -------- | --------- | :------: | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | download | `query` | boolean | `bool` | | | | Whether to initiate a download of the file or not. | | format | `query` | string | `string` | | | `"yaml"` | Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence. | #### All responses | Code | Status | Description | Has headers | Schema | | ---------------------------------------- | --------- | ------------------ | :---------: | -------------------------------------------------- | | [200](#route-get-alert-rules-export-200) | OK | AlertingFileExport | | [schema](#route-get-alert-rules-export-200-schema) | | [404](#route-get-alert-rules-export-404) | Not Found | Not found. | | [schema](#route-get-alert-rules-export-404-schema) | #### Responses ##### 200 - AlertingFileExport Status: OK ###### Schema [AlertingFileExport](#alerting-file-export) ##### 404 - Not found. Status: Not Found ###### Schema ### Get all the contact points. (_RouteGetContactpoints_) ``` GET /api/v1/provisioning/contact-points ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------- | ------ | -------- | --------- | :------: | ------- | -------------- | | name | `query` | string | `string` | | | | Filter by name | #### All responses | Code | Status | Description | Has headers | Schema | | ----------------------------------- | ------ | ------------- | :---------: | --------------------------------------------- | | [200](#route-get-contactpoints-200) | OK | ContactPoints | | [schema](#route-get-contactpoints-200-schema) | #### Responses ##### 200 - ContactPoints Status: OK ###### Schema [ContactPoints](#contact-points) ### Export all contact points in provisioning file format. (_RouteGetContactpointsExport_) ``` GET /api/v1/provisioning/contact-points/export ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------- | ------- | ------- | -------- | --------- | :------: | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | decrypt | `query` | boolean | `bool` | | | | Whether any contained secure settings should be decrypted or left redacted. Redacted settings will contain RedactedValue instead. Currently, only org admin can view decrypted secure settings. | | download | `query` | boolean | `bool` | | | | Whether to initiate a download of the file or not. | | format | `query` | string | `string` | | | `"yaml"` | Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence. | | name | `query` | string | `string` | | | | Filter by name | #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------------------ | --------- | ------------------ | :---------: | ---------------------------------------------------- | | [200](#route-get-contactpoints-export-200) | OK | AlertingFileExport | | [schema](#route-get-contactpoints-export-200-schema) | | [403](#route-get-contactpoints-export-403) | Forbidden | PermissionDenied | | [schema](#route-get-contactpoints-export-403-schema) | #### Responses ##### 200 - AlertingFileExport Status: OK ###### Schema [AlertingFileExport](#alerting-file-export) ##### 403 - PermissionDenied Status: Forbidden ###### Schema [PermissionDenied](#permission-denied) ### Get a mute timing. (_RouteGetMuteTiming_) ``` GET /api/v1/provisioning/mute-timings/:name ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | ---------------- | | name | `path` | string | `string` | | ✓ | | Mute timing name | #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | --------- | ---------------- | :---------: | ------------------------------------------- | | [200](#route-get-mute-timing-200) | OK | MuteTimeInterval | | [schema](#route-get-mute-timing-200-schema) | | [404](#route-get-mute-timing-404) | Not Found | Not found. | | [schema](#route-get-mute-timing-404-schema) | #### Responses ##### 200 - MuteTimeInterval Status: OK ###### Schema [MuteTimeInterval](#mute-time-interval) ##### 404 - Not found. Status: Not Found ###### Schema ### Get all the mute timings. (_RouteGetMuteTimings_) ``` GET /api/v1/provisioning/mute-timings ``` #### All responses | Code | Status | Description | Has headers | Schema | | ---------------------------------- | ------ | ----------- | :---------: | -------------------------------------------- | | [200](#route-get-mute-timings-200) | OK | MuteTimings | | [schema](#route-get-mute-timings-200-schema) | #### Responses ##### 200 - MuteTimings Status: OK ###### Schema [MuteTimings](#mute-timings) ### Get the notification policy tree. (_RouteGetPolicyTree_) ``` GET /api/v1/provisioning/policies ``` #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ------ | ----------- | :---------: | ------------------------------------------- | | [200](#route-get-policy-tree-200) | OK | Route | | [schema](#route-get-policy-tree-200-schema) | #### Responses ##### 200 - Route Status: OK ###### Schema [Route](#route) ### Export the notification policy tree in provisioning file format. (_RouteGetPolicyTreeExport_) ``` GET /api/v1/provisioning/policies/export ``` #### All responses | Code | Status | Description | Has headers | Schema | | ---------------------------------------- | --------- | ------------------ | :---------: | -------------------------------------------------- | | [200](#route-get-policy-tree-export-200) | OK | AlertingFileExport | | [schema](#route-get-policy-tree-export-200-schema) | | [404](#route-get-policy-tree-export-404) | Not Found | NotFound | | [schema](#route-get-policy-tree-export-404-schema) | #### Responses ##### 200 - AlertingFileExport Status: OK ###### Schema [AlertingFileExport](#alerting-file-export) ##### 404 - NotFound Status: Not Found ###### Schema [NotFound](#not-found) ### Get a notification template. (_RouteGetTemplate_) ``` GET /api/v1/provisioning/templates/:name ``` #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | ---- | ------ | ------ | -------- | --------- | :------: | ------- | ------------- | | name | `path` | string | `string` | | ✓ | | Template Name | #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------ | --------- | -------------------- | :---------: | ---------------------------------------- | | [200](#route-get-template-200) | OK | NotificationTemplate | | [schema](#route-get-template-200-schema) | | [404](#route-get-template-404) | Not Found | Not found. | | [schema](#route-get-template-404-schema) | #### Responses ##### 200 - NotificationTemplate Status: OK ###### Schema [NotificationTemplate](#notification-template) ##### 404 - Not found. Status: Not Found ###### Schema ### Get all notification templates. (_RouteGetTemplates_) ``` GET /api/v1/provisioning/templates ``` #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------- | --------- | --------------------- | :---------: | ----------------------------------------- | | [200](#route-get-templates-200) | OK | NotificationTemplates | | [schema](#route-get-templates-200-schema) | | [404](#route-get-templates-404) | Not Found | Not found. | | [schema](#route-get-templates-404-schema) | #### Responses ##### 200 - NotificationTemplates Status: OK ###### Schema [NotificationTemplates](#notification-templates) ##### 404 - Not found. Status: Not Found ###### Schema ### Create a new alert rule. (_RoutePostAlertRule_) ``` POST /api/v1/provisioning/alert-rules ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ----------------------------------------------- | ----------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [ProvisionedAlertRule](#provisioned-alert-rule) | `models.ProvisionedAlertRule` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ----------- | -------------------- | :---------: | ------------------------------------------- | | [201](#route-post-alert-rule-201) | Created | ProvisionedAlertRule | | [schema](#route-post-alert-rule-201-schema) | | [400](#route-post-alert-rule-400) | Bad Request | ValidationError | | [schema](#route-post-alert-rule-400-schema) | #### Responses ##### 201 - ProvisionedAlertRule Status: Created ###### Schema [ProvisionedAlertRule](#provisioned-alert-rule) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Create a contact point. (_RoutePostContactpoints_) ``` POST /api/v1/provisioning/contact-points ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ----------------------------------------------- | ----------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [EmbeddedContactPoint](#embedded-contact-point) | `models.EmbeddedContactPoint` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------------ | ----------- | -------------------- | :---------: | ---------------------------------------------- | | [202](#route-post-contactpoints-202) | Accepted | EmbeddedContactPoint | | [schema](#route-post-contactpoints-202-schema) | | [400](#route-post-contactpoints-400) | Bad Request | ValidationError | | [schema](#route-post-contactpoints-400-schema) | #### Responses ##### 202 - EmbeddedContactPoint Status: Accepted ###### Schema [EmbeddedContactPoint](#embedded-contact-point) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Create a new mute timing. (_RoutePostMuteTiming_) ``` POST /api/v1/provisioning/mute-timings ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | --------------------------------------- | ------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [MuteTimeInterval](#mute-time-interval) | `models.MuteTimeInterval` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | ---------------------------------- | ----------- | ---------------- | :---------: | -------------------------------------------- | | [201](#route-post-mute-timing-201) | Created | MuteTimeInterval | | [schema](#route-post-mute-timing-201-schema) | | [400](#route-post-mute-timing-400) | Bad Request | ValidationError | | [schema](#route-post-mute-timing-400-schema) | #### Responses ##### 201 - MuteTimeInterval Status: Created ###### Schema [MuteTimeInterval](#mute-time-interval) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Update an existing alert rule. (_RoutePutAlertRule_) ``` PUT /api/v1/provisioning/alert-rules/:uid ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ----------------------------------------------- | ----------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | UID | `path` | string | `string` | | ✓ | | Alert rule UID | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [ProvisionedAlertRule](#provisioned-alert-rule) | `models.ProvisionedAlertRule` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | -------------------------------- | ----------- | -------------------- | :---------: | ------------------------------------------ | | [200](#route-put-alert-rule-200) | OK | ProvisionedAlertRule | | [schema](#route-put-alert-rule-200-schema) | | [400](#route-put-alert-rule-400) | Bad Request | ValidationError | | [schema](#route-put-alert-rule-400-schema) | #### Responses ##### 200 - ProvisionedAlertRule Status: OK ###### Schema [ProvisionedAlertRule](#provisioned-alert-rule) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Update the interval or alert rules of a rule group. (_RoutePutAlertRuleGroup_) ``` PUT /api/v1/provisioning/folder/:folderUid/rule-groups/:group ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ----------------------------------- | ----------------------- | --------- | :------: | ------- | ------------------------------------------------------------------------------------------------------- | | FolderUID | `path` | string | `string` | | ✓ | | | | Group | `path` | string | `string` | | ✓ | | | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [AlertRuleGroup](#alert-rule-group) | `models.AlertRuleGroup` | | | | This action is idempotent and rules included in this body will overwrite configured rules for the group | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | -------------------------------------- | ----------- | --------------- | :---------: | ------------------------------------------------ | | [200](#route-put-alert-rule-group-200) | OK | AlertRuleGroup | | [schema](#route-put-alert-rule-group-200-schema) | | [400](#route-put-alert-rule-group-400) | Bad Request | ValidationError | | [schema](#route-put-alert-rule-group-400-schema) | #### Responses ##### 200 - AlertRuleGroup Status: OK ###### Schema [AlertRuleGroup](#alert-rule-group) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Update an existing contact point. (_RoutePutContactpoint_) ``` PUT /api/v1/provisioning/contact-points/:uid ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ----------------------------------------------- | ----------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | UID | `path` | string | `string` | | ✓ | | UID is the contact point unique identifier | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [EmbeddedContactPoint](#embedded-contact-point) | `models.EmbeddedContactPoint` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | ---------------------------------- | ----------- | --------------- | :---------: | -------------------------------------------- | | [202](#route-put-contactpoint-202) | Accepted | Ack | | [schema](#route-put-contactpoint-202-schema) | | [400](#route-put-contactpoint-400) | Bad Request | ValidationError | | [schema](#route-put-contactpoint-400-schema) | #### Responses ##### 202 - Ack Status: Accepted ###### Schema [Ack](#ack) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Replace an existing mute timing. (_RoutePutMuteTiming_) ``` PUT /api/v1/provisioning/mute-timings/:name ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | --------------------------------------- | ------------------------- | --------- | :------: | ------- | --------------------------------------------------------- | | name | `path` | string | `string` | | ✓ | | Mute timing name | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [MuteTimeInterval](#mute-time-interval) | `models.MuteTimeInterval` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ----------- | ---------------- | :---------: | ------------------------------------------- | | [200](#route-put-mute-timing-200) | OK | MuteTimeInterval | | [schema](#route-put-mute-timing-200-schema) | | [400](#route-put-mute-timing-400) | Bad Request | ValidationError | | [schema](#route-put-mute-timing-400-schema) | #### Responses ##### 200 - MuteTimeInterval Status: OK ###### Schema [MuteTimeInterval](#mute-time-interval) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Sets the notification policy tree. (_RoutePutPolicyTree_) ``` PUT /api/v1/provisioning/policies ``` #### Consumes - application/json #### Parameters {{% responsive-table %}} | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | --------------- | -------------- | --------- | :------: | ------- | --------------------------------------------------------- | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [Route](#route) | `models.Route` | | | | The new notification routing tree to use | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | --------------------------------- | ----------- | --------------- | :---------: | ------------------------------------------- | | [202](#route-put-policy-tree-202) | Accepted | Ack | | [schema](#route-put-policy-tree-202-schema) | | [400](#route-put-policy-tree-400) | Bad Request | ValidationError | | [schema](#route-put-policy-tree-400-schema) | #### Responses ##### 202 - Ack Status: Accepted ###### Schema [Ack](#ack) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Updates an existing notification template. (_RoutePutTemplate_) ``` PUT /api/v1/provisioning/templates/:name ``` #### Consumes - application/json {{% responsive-table %}} #### Parameters | Name | Source | Type | Go type | Separator | Required | Default | Description | | -------------------------- | -------- | ------------------------------------------------------------- | ------------------------------------ | --------- | :------: | ------- | --------------------------------------------------------- | | name | `path` | string | `string` | | ✓ | | Template Name | | X-Disable-Provenance: true | `header` | string | `string` | | | | Allows editing of provisioned resources in the Grafana UI | | Body | `body` | [NotificationTemplateContent](#notification-template-content) | `models.NotificationTemplateContent` | | | | | {{% /responsive-table %}} #### All responses | Code | Status | Description | Has headers | Schema | | ------------------------------ | ----------- | -------------------- | :---------: | ---------------------------------------- | | [202](#route-put-template-202) | Accepted | NotificationTemplate | | [schema](#route-put-template-202-schema) | | [400](#route-put-template-400) | Bad Request | ValidationError | | [schema](#route-put-template-400-schema) | #### Responses ##### 202 - NotificationTemplate Status: Accepted ###### Schema [NotificationTemplate](#notification-template) ##### 400 - ValidationError Status: Bad Request ###### Schema [ValidationError](#validation-error) ### Clears the notification policy tree. (_RouteResetPolicyTree_) ``` DELETE /api/v1/provisioning/policies ``` #### Consumes - application/json #### All responses | Code | Status | Description | Has headers | Schema | | ----------------------------------- | -------- | ----------- | :---------: | --------------------------------------------- | | [202](#route-reset-policy-tree-202) | Accepted | Ack | | [schema](#route-reset-policy-tree-202-schema) | #### Responses ##### 202 - Ack Status: Accepted ###### Schema [Ack](#ack) ## Models ### Ack [interface{}](#interface) ### AlertQuery **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | --------------------------------------------------------- | ----------------------------------------- | ------------------- | :------: | ------- | ------------------------------------------------------------------------------------------------------ | ------- | | datasourceUid | string | `string` | | | Grafana data source unique identifier; it should be '**expr**' for a Server Side Expression operation. | | | model | [interface{}](#interface) | `interface{}` | | | JSON is the raw JSON query and includes the above properties as well as custom properties. | | | queryType | string | `string` | | | QueryType is an optional identifier for the type of query. | | It can be used to distinguish different types of queries. | | | refId | string | `string` | | | RefID is the unique identifier of the query, set by the frontend call. | | | relativeTimeRange | [RelativeTimeRange](#relative-time-range) | `RelativeTimeRange` | | | | | {{% /responsive-table %}} ### AlertQueryExport **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ----------------- | ----------------------------------------- | ------------------- | :------: | ------- | ----------- | ------- | | datasourceUid | string | `string` | | | | | | model | [interface{}](#interface) | `interface{}` | | | | | | queryType | string | `string` | | | | | | refId | string | `string` | | | | | | relativeTimeRange | [RelativeTimeRange](#relative-time-range) | `RelativeTimeRange` | | | | | {{% /responsive-table %}} ### AlertRuleExport **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------ | ----------------------------------------- | --------------------- | :------: | ------- | ----------- | ------- | | annotations | map of string | `map[string]string` | | | | | | condition | string | `string` | | | | | | dashboardUid | string | `string` | | | | | | data | [][AlertQueryExport](#alert-query-export) | `[]*AlertQueryExport` | | | | | | execErrState | string | `string` | | | | | | for | [Duration](#duration) | `Duration` | | | | | | isPaused | boolean | `bool` | | | | | | labels | map of string | `map[string]string` | | | | | | noDataState | string | `string` | | | | | | panelId | int64 (formatted integer) | `int64` | | | | | | title | string | `string` | | | | | | uid | string | `string` | | | | | {{% /responsive-table %}} ### AlertRuleGroup **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | --------- | ------------------------------------------------- | ------------------------- | :------: | ------- | ----------- | ------- | | folderUid | string | `string` | | | | | | interval | int64 (formatted integer) | `int64` | | | | | | rules | [][ProvisionedAlertRule](#provisioned-alert-rule) | `[]*ProvisionedAlertRule` | | | | | | title | string | `string` | | | | | {{% /responsive-table %}} ### AlertRuleGroupExport **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | -------- | --------------------------------------- | -------------------- | :------: | ------- | ----------- | ------- | | folder | string | `string` | | | | | | interval | [Duration](#duration) | `Duration` | | | | | | name | string | `string` | | | | | | orgId | int64 (formatted integer) | `int64` | | | | | | rules | [][AlertRuleExport](#alert-rule-export) | `[]*AlertRuleExport` | | | | | {{% /responsive-table %}} ### AlertingFileExport **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------- | --------------------------------------------------------- | ----------------------------- | :------: | ------- | ----------- | ------- | | apiVersion | int64 (formatted integer) | `int64` | | | | | | contactPoints | [][ContactPointExport](#contact-point-export) | `[]*ContactPointExport` | | | | | | groups | [][AlertRuleGroupExport](#alert-rule-group-export) | `[]*AlertRuleGroupExport` | | | | | | policies | [][NotificationPolicyExport](#notification-policy-export) | `[]*NotificationPolicyExport` | | | | | {{% /responsive-table %}} ### ContactPointExport **Properties** | Name | Type | Go type | Required | Default | Description | Example | | --------- | ------------------------------------ | ------------------- | :------: | ------- | ----------- | ------- | | name | string | `string` | | | | | | orgId | int64 (formatted integer) | `int64` | | | | | | receivers | [][ReceiverExport](#receiver-export) | `[]*ReceiverExport` | | | | | ### ContactPoints [][EmbeddedContactPoint](#embedded-contact-point) ### Duration | Name | Type | Go type | Default | Description | Example | | -------- | ------------------------- | ------- | ------- | ----------- | ------- | | Duration | int64 (formatted integer) | int64 | | | | ### EmbeddedContactPoint > EmbeddedContactPoint is the contact point type that is used > by grafanas embedded alertmanager implementation. **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------------------------------ | ----------------------- | -------- | :------: | ------- | ----------------------------------------------------------------- | --------- | | disableResolveMessage | boolean | `bool` | | | | `false` | | name | string | `string` | | | Name is used as grouping key in the UI. Contact points with the | | same name will be grouped in the UI. | `webhook_1` | | provenance | string | `string` | | | | | | settings | [JSON](#json) | `JSON` | ✓ | | | | | type | string | `string` | ✓ | | | `webhook` | | uid | string | `string` | | | UID is the unique identifier of the contact point. The UID can be | | set by the user. | `my_external_reference` | {{% /responsive-table %}} ### Json [interface{}](#interface) ### MatchRegexps [MatchRegexps](#match-regexps) ### MatchType | Name | Type | Go type | Default | Description | Example | | --------- | ------------------------- | ------- | ------- | ----------- | ------- | | MatchType | int64 (formatted integer) | int64 | | | | ### Matcher **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ----- | ------------------------ | ----------- | :------: | ------- | ----------- | ------- | | Name | string | `string` | | | | | | Type | [MatchType](#match-type) | `MatchType` | | | | | | Value | string | `string` | | | | | {{% /responsive-table %}} ### Matchers > Matchers is a slice of Matchers that is sortable, implements Stringer, and > provides a Matches method to match a LabelSet against all Matchers in the > slice. Note that some users of Matchers might require it to be sorted. [][Matcher](#matcher) ### MuteTimeInterval **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | -------------- | -------------------------------- | ----------------- | :------: | ------- | ----------- | ------- | | name | string | `string` | | | | | | time_intervals | [][TimeInterval](#time-interval) | `[]*TimeInterval` | | | | | {{% /responsive-table %}} ### MuteTimings [][MuteTimeInterval](#mute-time-interval) ### NotFound [interface{}](#interface) ### NotificationPolicyExport **Properties** | Name | Type | Go type | Required | Default | Description | Example | | ------ | ---------------------------- | ------------- | :------: | ------- | ----------- | ------- | | Policy | [RouteExport](#route-export) | `RouteExport` | | | inline | | | orgId | int64 (formatted integer) | `int64` | | | | | ### NotificationTemplate **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ---------- | ------------------------- | ------------ | :------: | ------- | ----------- | ------- | | name | string | `string` | | | | | | provenance | [Provenance](#provenance) | `Provenance` | | | | | | template | string | `string` | | | | | {{% /responsive-table %}} ### NotificationTemplateContent **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | -------- | ------ | -------- | :------: | ------- | ----------- | ------- | | template | string | `string` | | | | | {{% /responsive-table %}} ### NotificationTemplates [][NotificationTemplate](#notification-template) ### ObjectMatchers [Matchers](#matchers) #### Inlined models ### PermissionDenied [interface{}](#interface) ### Provenance | Name | Type | Go type | Default | Description | Example | | ---------- | ------ | ------- | ------- | ----------- | ------- | | Provenance | string | string | | | | ### ProvisionedAlertRule **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------ | ---------------------------- | ------------------- | :------: | ------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | annotations | map of string | `map[string]string` | | | | `{"runbook_url":"https://supercoolrunbook.com/page/13"}` | | condition | string | `string` | ✓ | | | `A` | | data | [][AlertQuery](#alert-query) | `[]*AlertQuery` | ✓ | | | `[{"datasourceUid":"__expr__","model":{"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":[]},"reducer":{"params":[],"type":"avg"},"type":"query"}],"datasource":{"type":"__expr__","uid":"__expr__"},"expression":"1 == 1","hide":false,"intervalMs":1000,"maxDataPoints":43200,"refId":"A","type":"math"},"queryType":"","refId":"A","relativeTimeRange":{"from":0,"to":0}}]` | | execErrState | string | `string` | ✓ | | | | | folderUID | string | `string` | ✓ | | | `project_x` | | for | [Duration](#duration) | `Duration` | ✓ | | | | | id | int64 (formatted integer) | `int64` | | | | | | isPaused | boolean | `bool` | | | | `false` | | labels | map of string | `map[string]string` | | | | `{"team":"sre-team-1"}` | | noDataState | string | `string` | ✓ | | | | | orgID | int64 (formatted integer) | `int64` | ✓ | | | | | provenance | [Provenance](#provenance) | `Provenance` | | | | | | ruleGroup | string | `string` | ✓ | | | `eval_group_1` | | title | string | `string` | ✓ | | | `Always firing` | | uid | string | `string` | | | | | | updated | date-time (formatted string) | `strfmt.DateTime` | | | | | {{% /responsive-table %}} ### ProvisionedAlertRules [][ProvisionedAlertRule](#provisioned-alert-rule) ### RawMessage [interface{}](#interface) ### ReceiverExport **Properties** | Name | Type | Go type | Required | Default | Description | Example | | --------------------- | -------------------------- | ------------ | :------: | ------- | ----------- | ------- | | disableResolveMessage | boolean | `bool` | | | | | | settings | [RawMessage](#raw-message) | `RawMessage` | | | | | | type | string | `string` | | | | | | uid | string | `string` | | | | | ### Regexp > A Regexp is safe for concurrent use by multiple goroutines, > except for configuration methods, such as Longest. [interface{}](#interface) ### RelativeTimeRange > RelativeTimeRange is the per query start and end time > for requests. **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ---- | --------------------- | ---------- | :------: | ------- | ----------- | ------- | | from | [Duration](#duration) | `Duration` | | | | | | to | [Duration](#duration) | `Duration` | | | | | {{% /responsive-table %}} ### Route > A Route is a node that contains definitions of how to handle alerts. This is modified > from the upstream alertmanager in that it adds the ObjectMatchers property. **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------------- | ---------------------------------- | ------------------- | :------: | ------- | --------------------------------------- | ------- | | continue | boolean | `bool` | | | | | | group_by | []string | `[]string` | | | | | | group_interval | string | `string` | | | | | | group_wait | string | `string` | | | | | | match | map of string | `map[string]string` | | | Deprecated. Remove before v1.0 release. | | | match_re | [MatchRegexps](#match-regexps) | `MatchRegexps` | | | | | | matchers | [Matchers](#matchers) | `Matchers` | | | | | | mute_time_intervals | []string | `[]string` | | | | | | object_matchers | [ObjectMatchers](#object-matchers) | `ObjectMatchers` | | | | | | provenance | [Provenance](#provenance) | `Provenance` | | | | | | receiver | string | `string` | | | | | | repeat_interval | string | `string` | | | | | | routes | [][Route](#route) | `[]*Route` | | | | | {{% /responsive-table %}} ### RouteExport > RouteExport is the provisioned file export of definitions.Route. This is needed to hide fields that aren't usable in > provisioning file format. An alternative would be to define a custom MarshalJSON and MarshalYAML that excludes them. **Properties** | Name | Type | Go type | Required | Default | Description | Example | | ------------------- | ---------------------------------- | ------------------- | :------: | ------- | --------------------------------------- | ------- | | continue | boolean | `bool` | | | | | | group_by | []string | `[]string` | | | | | | group_interval | string | `string` | | | | | | group_wait | string | `string` | | | | | | match | map of string | `map[string]string` | | | Deprecated. Remove before v1.0 release. | | | match_re | [MatchRegexps](#match-regexps) | `MatchRegexps` | | | | | | matchers | [Matchers](#matchers) | `Matchers` | | | | | | mute_time_intervals | []string | `[]string` | | | | | | object_matchers | [ObjectMatchers](#object-matchers) | `ObjectMatchers` | | | | | | receiver | string | `string` | | | | | | repeat_interval | string | `string` | | | | | | routes | [][RouteExport](#route-export) | `[]*RouteExport` | | | | | ### TimeInterval > TimeInterval describes intervals of time. ContainsTime will tell you if a golang time is contained > within the interval. **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ------------- | -------------------------- | -------------- | :------: | ------- | ----------- | ------- | | days_of_month | []string | `[]string` | | | | | | location | string | `string` | | | | | | months | []string | `[]string` | | | | | | times | [][TimeRange](#time-range) | `[]*TimeRange` | | | | | | weekdays | []string | `[]string` | | | | | | years | []string | `[]string` | | | | | {{% /responsive-table %}} ### TimeRange > For example, 4:00PM to End of the day would Begin at 1020 and End at 1440. **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ----------- | ------------------------- | ------- | :------: | ------- | ----------- | ------- | | EndMinute | int64 (formatted integer) | `int64` | | | | | | StartMinute | int64 (formatted integer) | `int64` | | | | | {{% /responsive-table %}} ### ValidationError **Properties** {{% responsive-table %}} | Name | Type | Go type | Required | Default | Description | Example | | ---- | ------ | -------- | :------: | ------- | ----------- | --------------- | | msg | string | `string` | | | | `error message` | {{% /responsive-table %}}