diff --git a/main/docs/oas/tenant-logs/logs-schema.json b/main/docs/oas/tenant-logs/logs-schema.json
index 5ffefac460..926d96618d 100644
--- a/main/docs/oas/tenant-logs/logs-schema.json
+++ b/main/docs/oas/tenant-logs/logs-schema.json
@@ -33495,7 +33495,8 @@
               "body": {
                 "properties": {
                   "app_metadata": {
-                    "type": "object"
+                    "type": "object",
+                    "description": "App metadata included directly in the signup request body by the calling client. This field is not populated from metadata set by pre-registration Actions; app_metadata applied by Actions is written to the user record but does not appear in the log body."
                   },
                   "blocked": {
                     "type": "boolean"
@@ -33655,6 +33656,7 @@
                     "type": "string"
                   },
                   "user_metadata": {
+                    "description": "User metadata included directly in the signup request body by the calling client. This field is not populated from metadata set by pre-registration Actions and does not reflect the final user record.",
                     "anyOf": [
                       {
                         "type": "string"