From 1b39e41ba6c5e97dfd1fc40693670e5b656491a7 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Tue, 30 Jun 2026 15:53:25 +0000 Subject: [PATCH] Document Flash endpoint/app lifecycle operations are CLI-only Flash SDK v1.18.0 (runpod/flash#346) restricts lifecycle operations (deploy, undeploy, update, app/env create/delete) to the CLI; direct SDK calls now raise FlashUsageError. Add a Note on the deploy page and a Breaking entry to the product updates page. --- flash/apps/deploy-apps.mdx | 4 ++++ release-notes.mdx | 8 ++++++++ 2 files changed, 12 insertions(+) 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 ``` + +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. + + 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 12f832ce..99026d93 100644 --- a/release-notes.mdx +++ b/release-notes.mdx @@ -4,6 +4,14 @@ sidebarTitle: "Product updates" description: "New features, fixes, and improvements for the Runpod platform." --- + +### Jun.30 Breaking — Lifecycle operations are now CLI-only + +:warning: 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. + +Tags: [Flash] + + ## Flash beta: Run Python functions on cloud GPUs