fix syntax in oas (#16485)

Co-authored-by: Rijk van Zanten <rijkvanzanten@me.com>

packages/specs/src/openapi.yaml

@@ -287,8 +287,21 @@ components:
       $ref: './components/setting.yaml'
     Users:
       $ref: './components/user.yaml'
+    Query:
+      $ref: './definitions/query.yaml'
     Webhooks:
       $ref: './components/webhook.yaml'
+    x-metadata:
+      type: object
+      properties:
+        total_count:
+          description: Returns the total item count of the collection you're querying.
+          type: integer
+        filter_count:
+          description:
+            Returns the item count of the collection you're querying, taking the current filter/search parameters into
+            account.
+          type: integer
   parameters:
     # All path parameters
     Id:
@@ -317,9 +330,6 @@ components:
       $ref: './parameters/fields.yaml'
     Mode:
       $ref: './parameters/mode.yaml'
-  definitions:
-    Query:
-      $ref: './definitions/query.yaml'
   responses:
     NotFoundError:
       $ref: './responses/notFoundError.yaml'
@@ -334,17 +344,6 @@ components:
       type: apiKey
       in: header
       name: 'Authorization'
-  x-metadata:
-    type: object
-    properties:
-      total_count:
-        description: Returns the total item count of the collection you're querying.
-        type: integer
-      filter_count:
-        description:
-          Returns the item count of the collection you're querying, taking the current filter/search parameters into
-          account.
-        type: integer
 security:
   - Auth: []
   - KeyAuth: []

packages/specs/src/paths/activity/activities.yaml

@@ -23,7 +23,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Activity'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
       description: Successful request
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'

packages/specs/src/paths/files/files.yaml

@@ -25,7 +25,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Files'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
 

packages/specs/src/paths/flows/flows.yaml

@@ -15,7 +15,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Flows'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/folders/folders.yaml

@@ -23,7 +23,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Folders'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/items/items.yaml

@@ -28,7 +28,7 @@ get:
                 items:
                   type: object
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
 

packages/specs/src/paths/operations/operations.yaml

@@ -15,7 +15,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Operations'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/permissions/permissions.yaml

@@ -25,7 +25,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Permissions'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/presets/presets.yaml

@@ -29,7 +29,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Presets'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
 

packages/specs/src/paths/revisions/revisions.yaml

@@ -25,7 +25,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Revisions'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/roles/roles.yaml

@@ -25,7 +25,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Roles'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/users/users.yaml

@@ -24,7 +24,7 @@ get:
                 items:
                   $ref: '../../openapi.yaml#/components/schemas/Users'
               meta:
-                $ref: '../../openapi.yaml#/components/x-metadata'
+                $ref: '../../openapi.yaml#/components/schemas/x-metadata'
     '401':
       $ref: '../../openapi.yaml#/components/responses/UnauthorizedError'
     '404':

packages/specs/src/paths/utils/export.yaml

@@ -18,16 +18,11 @@ post:
               description: What file format to save the export to. One of csv, xml, json
               type: string
               enum: ['csv', 'xml', 'json']
-              required: true
             query:
-              description: The query object to use for the export
-              required: true
-              $ref: '../../openapi.yaml#/components/definitions/Query'
+              $ref: '../../openapi.yaml#/components/schemas/Query'
             file:
-              description: Partial file object to tweak where / how the export file is saved
-              type: object
-              required: true
               $ref: '../../openapi.yaml#/components/schemas/Files'
+          required: ['format','query','file']
   responses:
     '200':
       description: Successful request

packages/specs/src/paths/utils/hash-generate.yaml

@@ -10,7 +10,7 @@ post:
             string:
               description: String to hash.
               type: string
-              required: true
+          required: ['string']
   responses:
     '200':
       content:

packages/specs/src/paths/utils/hash-verify.yaml

@@ -10,11 +10,10 @@ post:
             string:
               description: String to hash.
               type: string
-              required: true
             hash:
               description: Hash you want to verify against.
               type: string
-              required: true
+          required: ['string', 'hash']
   responses:
     '200':
       content: