diff --git a/spec/rails/doc/openapi.yaml b/spec/rails/doc/openapi.yaml
index 9d2f3612..78e4cc91 100644
--- a/spec/rails/doc/openapi.yaml
+++ b/spec/rails/doc/openapi.yaml
@@ -14,44 +14,20 @@ paths:
       summary: index
       tags:
       - Table
-      parameters:
-      - name: page
-        in: query
-        schema:
-          type: integer
-        example: 1
-      - name: per
-        in: query
-        schema:
-          type: integer
-        example: 10
-      - name: filter[name]
-        in: query
-        schema:
-          type: object
-          properties:
-            name:
-              type: string
-        example:
-          name: Example Table
-      - name: filter[price]
-        in: query
-        schema:
-          type: object
-          properties:
-            price:
-              type: string
-        example:
-          price: '0'
-      - name: X-Authorization-Token
-        in: header
-        required: true
-        schema:
-          type: string
-        example: token
       responses:
+        '401':
+          description: does not return tables if unauthorized
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+              example:
+                message: Unauthorized
         '200':
-          description: returns a list of tables
+          description: with flat query parameters
           content:
             application/json:
               schema:
@@ -92,17 +68,41 @@ paths:
                 storage_size: 12.3
                 created_at: '2020-07-17T00:00:00+00:00'
                 updated_at: '2020-07-17T00:00:00+00:00'
-        '401':
-          description: does not return tables if unauthorized
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  message:
-                    type: string
-              example:
-                message: Unauthorized
+      parameters:
+      - name: page
+        in: query
+        schema:
+          type: integer
+        example: 1
+      - name: per
+        in: query
+        schema:
+          type: integer
+        example: 10
+      - name: X-Authorization-Token
+        in: header
+        required: true
+        schema:
+          type: string
+        example: token
+      - name: filter[name]
+        in: query
+        schema:
+          type: object
+          properties:
+            name:
+              type: string
+        example:
+          name: Example Table
+      - name: filter[price]
+        in: query
+        schema:
+          type: object
+          properties:
+            price:
+              type: string
+        example:
+          price: '0'
     post:
       summary: create
       tags:
@@ -176,12 +176,6 @@ paths:
         schema:
           type: integer
         example: 1
-      - name: id
-        in: path
-        required: true
-        schema:
-          type: integer
-        example: 2
       responses:
         '200':
           description: returns a table