diff --git a/.changelog/16743.txt b/.changelog/16743.txt
new file mode 100644
index 00000000000..45cef4ba729
--- /dev/null
+++ b/.changelog/16743.txt
@@ -0,0 +1,3 @@
+```release-note:improvement
+api: return a structured error for unexpected responses
+```