diff --git a/.changeset/pr-3125-release-note.md b/.changeset/pr-3125-release-note.md
new file mode 100644
index 000000000..650382d2e
--- /dev/null
+++ b/.changeset/pr-3125-release-note.md
@@ -0,0 +1,5 @@
+---
+type: Fixed
+pr: 3125
+---
+Fixes for issue #3125 were applied to keep command/workflow behavior and SDK parity aligned with current documented usage.