diff --git a/content/manuals/ai/sandboxes/customize/build-an-agent.md b/content/manuals/ai/sandboxes/customize/build-an-agent.md
index a874385a4de..237e25e209e 100644
--- a/content/manuals/ai/sandboxes/customize/build-an-agent.md
+++ b/content/manuals/ai/sandboxes/customize/build-an-agent.md
@@ -249,8 +249,7 @@ outbound requests to `ampcode.com`.
 > rejected.
 
 > [!NOTE]
-> `sbx secret set-custom` is an experimental command and isn't listed
-> in `sbx secret --help`. It works today but may change in future
+> `sbx secret set-custom` is experimental and may change in future
 > releases. This tutorial surfaces it because there's no other path to
 > register a custom-format placeholder.
 
@@ -329,7 +328,4 @@ the host to `sbx secret rm`:
 $ sbx secret rm -g --host ampcode.com
 ```
 
-The `--host` flag on `sbx secret rm` isn't listed in
-`sbx secret rm --help`, but it's the only way to remove entries
-created with `set-custom`. Like `set-custom` itself, it's experimental
-and may change.
+The `--host` flag is part of the experimental `set-custom` surface and doesn't appear in `sbx secret rm --help`.
diff --git a/content/manuals/ai/sandboxes/security/credentials.md b/content/manuals/ai/sandboxes/security/credentials.md
index 73a9ce6b8bc..eda4d9e96de 100644
--- a/content/manuals/ai/sandboxes/security/credentials.md
+++ b/content/manuals/ai/sandboxes/security/credentials.md
@@ -173,9 +173,8 @@ network policy. For details, see
 ## Custom secrets
 
 > [!IMPORTANT]
-> Custom secrets are experimental. The `set-custom` command is hidden
-> from `sbx --help`, and behavior, flags, and the placeholder format may
-> change.
+> Custom secrets are experimental. Behavior, flags, and the placeholder format may
+> change without notice.
 
 For credentials that don't fit the service-identifier model — for example,
 when an agent validates the environment variable format at boot, or when the