From 30cbaefcc7396777dc2ef98fd780b875817f63a8 Mon Sep 17 00:00:00 2001
From: DSollickOnyx <86113943+DSollickOnyx@users.noreply.github.com>
Date: Fri, 18 Feb 2022 11:45:33 -0500
Subject: [PATCH] Add reference to purge on destroy feature flag for APIM
 (#15511)

---
 website/docs/r/api_management.html.markdown | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/website/docs/r/api_management.html.markdown b/website/docs/r/api_management.html.markdown
index c39daa8b4057..71a0061ad085 100644
--- a/website/docs/r/api_management.html.markdown
+++ b/website/docs/r/api_management.html.markdown
@@ -14,6 +14,8 @@ Manages an API Management Service.
 
 -> When creating a new API Management resource in version 3.0 of the AzureRM Provider and later, please be aware that the AzureRM Provider will now clean up any sample APIs and Products created by the Azure API during the creation of the API Management resource.
 
+-> **Note:** Version 2.77 and later of the Azure Provider include a Feature Toggle which will purge an API Management resource on destroy, rather than the default soft-delete. See [the Features block documentation](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs#features) for more information on Feature Toggles within Terraform.
+
 ~> **Note:** It's possible to define Custom Domains both within [the `azurerm_api_management` resource](api_management.html) via the `hostname_configurations` block and by using [the `azurerm_api_management_custom_domain` resource](api_management_custom_domain.html). However it's not possible to use both methods to manage Custom Domains within an API Management Service, since there'll be conflicts.
 
 ## Example Usage