From de53863a6b1dce99a3f601f2931d8bdc51f1b2c7 Mon Sep 17 00:00:00 2001
From: "Grot (@grafanabot)" <43478413+grafanabot@users.noreply.github.com>
Date: Tue, 13 Dec 2022 11:50:41 +0000
Subject: [PATCH] [v9.3.x] Docs: adds workaround for editing provisioned rules
 using the HTTP API (#60224)

Docs: adds workaround for editing provisioned rules using the HTTP API (#59094)

* Docs: adds workaround for editing provisioned rules using api

* updates text

* updates text take two

(cherry picked from commit 6c6103d573337f05b0b1430af2f977290cdc7b4f)

Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
---
 .../provision-alerting-resources/_index.md       | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/sources/alerting/set-up/provision-alerting-resources/_index.md b/docs/sources/alerting/set-up/provision-alerting-resources/_index.md
index 62607174801..d120f492b05 100644
--- a/docs/sources/alerting/set-up/provision-alerting-resources/_index.md
+++ b/docs/sources/alerting/set-up/provision-alerting-resources/_index.md
@@ -20,15 +20,25 @@ There are three options to choose from:
 
 1. Use file provisioning to provision your Grafana Alerting resources, such as alert rules and contact points, through files on disk.
 
-1. Provision your alerting resources using the Grafana HTTP API.
+1. Provision your alerting resources using the Alerting Provisioning HTTP API.
 
-   For more information on the Grafana Alerting provisioning API, refer to [Alerting provisioning API](https://grafana.com/docs/grafana/latest/developers/http_api/alerting_provisioning/).
+   For more information on the Alerting Provisioning HTTP API, refer to [Alerting provisioning API](https://grafana.com/docs/grafana/latest/developers/http_api/alerting_provisioning/).
+
+   **Note:**
+
+   Typically, you cannot edit API-provisioned alert rules from the Grafana UI.
+
+   In order to enable editing, add the x-disable-provenance header to the following requests when creating or editing your alert rules in the API:
+
+   POST /api/v1/provisioning/alert-rules
+
+   PUT /api/v1/provisioning/alert-rules/{UID}
 
 1. Provision your alerting resources using Terraform.
 
 **Note:**
 
-Currently, provisioning for Grafana Alerting supports alert rules, contact points, mute timings, and templates. Provisioned alerting resources can only be edited in the source that created them and not from within Grafana or any other source. For example, if you provision your alerting resources using files from disk, you cannot edit the data in Terraform or from within Grafana.
+Currently, provisioning for Grafana Alerting supports alert rules, contact points, mute timings, and templates. Provisioned alerting resources using file provisioning or Terraform can only be edited in the source that created them and not from within Grafana or any other source. For example, if you provision your alerting resources using files from disk, you cannot edit the data in Terraform or from within Grafana.
 
 **Useful Links:**