diff --git a/src/content/docs/new-relic-control/pipeline-control/cloud-rules-api.mdx b/src/content/docs/new-relic-control/pipeline-control/cloud-rules-api.mdx
index 42d8b1b1f34..fa57e59d2b5 100644
--- a/src/content/docs/new-relic-control/pipeline-control/cloud-rules-api.mdx
+++ b/src/content/docs/new-relic-control/pipeline-control/cloud-rules-api.mdx
@@ -314,6 +314,30 @@ mutation {
   }
 }
 ```
+
+## Update cloud rules [#update-rules]
+
+```graphql
+mutation UpdatePipelineCloudRule {
+    updatePipelineCloudRule(
+        id: "MTAyNTY1MHxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5ODgwOTUtMmZjNC03MTQ3LTkxMjQtZDk3YjhiY2Y4NGNj", # Replace with your rule's actual entity ID
+        pipelineCloudRuleEntity: {
+            description: "Since we do not need dropAttr1 ingested we would drop this attribuute instead of dropAttr1 ",
+            name: "Update the name for Dropping dropAttr2 from MyEventToDrop",
+            nrql: "DELETE dropAttr2 FROM MyEventToDrop"
+        }
+    ) {
+        entity {
+            id
+            type
+            name
+            description
+            nrql
+        }
+    }
+}
+```
+
 ## Delete a cloud rule [#delete-rule]
 
 ```graphql