diff --git a/plugins/modules/api_gateway.py b/plugins/modules/api_gateway.py
index af443238738..3bdb03e223c 100644
--- a/plugins/modules/api_gateway.py
+++ b/plugins/modules/api_gateway.py
@@ -165,6 +165,16 @@
       automation: ansible
     lookup: tags
     state: absent
+
+- name: Update API Gateway tags with purge_tags
+  community.aws.api_gateway:
+    api_id: "abc123def456"
+    name: "my-api"
+    state: present
+    purge_tags: true
+    tags:
+      Environment: Production
+      Project: WebServices
 """
 
 RETURN = r"""