diff --git a/swagger/docs.go b/swagger/docs.go
index ff967336c..e332125b1 100644
--- a/swagger/docs.go
+++ b/swagger/docs.go
@@ -2136,6 +2136,7 @@ const docTemplate = `{
                     "type": "number"
                 },
                 "instrumental": {
+                    "description": "Simple mode: use text as description; optional instrumental / vocal_language",
                     "type": "boolean"
                 },
                 "keyscale": {
@@ -2157,6 +2158,7 @@ const docTemplate = `{
                     "type": "string"
                 },
                 "think": {
+                    "description": "Advanced mode",
                     "type": "boolean"
                 },
                 "timesignature": {
diff --git a/swagger/swagger.json b/swagger/swagger.json
index 07ecd372e..7c7151f77 100644
--- a/swagger/swagger.json
+++ b/swagger/swagger.json
@@ -2129,6 +2129,7 @@
                     "type": "number"
                 },
                 "instrumental": {
+                    "description": "Simple mode: use text as description; optional instrumental / vocal_language",
                     "type": "boolean"
                 },
                 "keyscale": {
@@ -2150,6 +2151,7 @@
                     "type": "string"
                 },
                 "think": {
+                    "description": "Advanced mode",
                     "type": "boolean"
                 },
                 "timesignature": {
diff --git a/swagger/swagger.yaml b/swagger/swagger.yaml
index 4b6889ed9..e2323a05a 100644
--- a/swagger/swagger.yaml
+++ b/swagger/swagger.yaml
@@ -412,6 +412,8 @@ definitions:
       duration_seconds:
         type: number
       instrumental:
+        description: 'Simple mode: use text as description; optional instrumental
+          / vocal_language'
         type: boolean
       keyscale:
         type: string
@@ -426,6 +428,7 @@ definitions:
       text:
         type: string
       think:
+        description: Advanced mode
         type: boolean
       timesignature:
         type: string