diff --git a/reference/api/chats.mdx b/reference/api/chats.mdx
index 802dbe7be..e4de0c132 100644
--- a/reference/api/chats.mdx
+++ b/reference/api/chats.mdx
@@ -37,6 +37,10 @@ curl \
 
 <RouteHighlighter method="PATCH" path="/chats/{workspace}/settings" />
 
+<Note>
+The first call to `PATCH /chats/{workspace}/settings` will create the workspace UID if it doesn’t already exist.
+</Note>
+
 Configure the LLM provider and settings for a chat workspace.
 
 ```json