diff --git a/flash/apps/deploy-apps.mdx b/flash/apps/deploy-apps.mdx
index da54d222..6c09970d 100644
--- a/flash/apps/deploy-apps.mdx
+++ b/flash/apps/deploy-apps.mdx
@@ -13,6 +13,10 @@ flash deploy
 uv run flash deploy
 ```
 
+<Note>
+The Flash CLI manages endpoint and app lifecycle operations: `deploy`, `undeploy`, `update`, and creating or deleting apps and environments. If you call these methods directly from the SDK, Flash raises a `FlashUsageError` that names the equivalent `flash` command. Routing lifecycle changes through the CLI keeps the build and manifest pipeline aligned with Flash's local state tracking. Direct SDK calls bypass that orchestration and can leave deployments in an inconsistent state.
+</Note>
+
 This command performs the following steps:
 
 1. **Build**: Packages your code, dependencies, and manifest.
diff --git a/release-notes.mdx b/release-notes.mdx
index dd9e3a6d..23124309 100644
--- a/release-notes.mdx
+++ b/release-notes.mdx
@@ -22,6 +22,10 @@ description: "New features, fixes, and improvements for the Runpod platform."
 
   <Accordion title="June 2026">
 
+    <h4><Badge color="red">Breaking</Badge> Lifecycle operations are now CLI-only</h4>
+
+    Flash SDK methods for endpoint and app lifecycle operations—deploy, undeploy, update, and creating or deleting apps and environments—now raise a `FlashUsageError` that points to the equivalent `flash` command. Run these operations through the [Flash CLI](/flash/cli/overview) instead, which keeps the build and manifest pipeline and local state tracking consistent.
+
     <h4><Badge color="green">New Release</Badge> High-Performance Network Volumes now available</h4>
 
     You can now attach high-performance network volumes to [Pods, Serverless endpoints, and Instant Clusters](/storage/network-volumes) for significantly faster model load times. Look for the purple diamond icon to identify compatible datacenters.