diff --git a/api-docs/influxdb3/enterprise/v3/ref.yml b/api-docs/influxdb3/enterprise/v3/ref.yml
index 30d6dcac0..d8baaec21 100644
--- a/api-docs/influxdb3/enterprise/v3/ref.yml
+++ b/api-docs/influxdb3/enterprise/v3/ref.yml
@@ -2021,12 +2021,12 @@ components:
     QueryRequestObject:
       type: object
       properties:
-        database:
+        db:
           description: |
             The name of the database to query.
-            Required if the query (`query_str`) doesn't specify the database.
+            Required if the query (`q`) doesn't specify the database.
           type: string
-        query_str:
+        q:
           description: The query to execute.
           type: string
         format:
@@ -2045,11 +2045,11 @@ components:
           type: object
           additionalProperties: true
       required:
-        - database
-        - query_str
+        - db
+        - q
       example:
-        database: mydb
-        query_str: SELECT * FROM mytable
+        db: mydb
+        q: SELECT * FROM mytable
         format: json
         params: {}
     CreateDatabaseRequest: