diff --git a/doc/compiled.json b/doc/compiled.json
index 08a4b448f..abff93837 100644
--- a/doc/compiled.json
+++ b/doc/compiled.json
@@ -9655,12 +9655,12 @@
                     "example": "my-feature-branch"
                   },
                   "name": {
-                    "description": "Locale name",
+                    "description": "Locale name. Must be unique per project.",
                     "type": "string",
                     "example": "de"
                   },
                   "code": {
-                    "description": "Locale ISO code",
+                    "description": "Locale ISO code. Unlike `name`, `code` is not required to be unique per project - creating a locale whose `code` duplicates an existing locale's `code` in the same project will succeed rather than error, resulting in two locales that share the same code.",
                     "type": "string",
                     "example": "de-DE"
                   },
diff --git a/paths/locales/create.yaml b/paths/locales/create.yaml
index 9ed88450d..0f52ebec7 100644
--- a/paths/locales/create.yaml
+++ b/paths/locales/create.yaml
@@ -64,11 +64,11 @@ requestBody:
             type: string
             example: my-feature-branch
           name:
-            description: Locale name
+            description: Locale name. Must be unique per project.
             type: string
             example: de
           code:
-            description: Locale ISO code
+            description: Locale ISO code. Unlike `name`, `code` is not required to be unique per project - creating a locale whose `code` duplicates an existing locale's `code` in the same project will succeed rather than error, resulting in two locales that share the same code.
             type: string
             example: de-DE
           default: