feat(sdk): automated oas update (#3297)

Co-authored-by: kong[bot] <123129154+kong[bot]@users.noreply.github.com>
Co-authored-by: Angel <Guaris@users.noreply.github.com>

Author: kong[bot]

api-specs/konnect/analytics-dashboards/openapi.yaml

@@ -7,6 +7,8 @@ info:
   contact:
     name: Kong
     url: 'https://cloud.konghq.com'
+  x-oas-source: kong/platform-api@b6321606a76ff4d736b45a17640baf5021adc6c6
+  x-oas-source-link: 'https://github.com/Kong/platform-api/commit/b6321606a76ff4d736b45a17640baf5021adc6c6'
 servers:
   - url: 'https://us.api.konghq.com/v2'
     description: United-States Production region

api-specs/konnect/analytics-requests/v2/openapi.yaml

@@ -6,6 +6,8 @@ info:
   contact:
     name: Kong
     url: 'https://cloud.konghq.com'
+  x-oas-source: kong/platform-api@b6321606a76ff4d736b45a17640baf5021adc6c6
+  x-oas-source-link: 'https://github.com/Kong/platform-api/commit/b6321606a76ff4d736b45a17640baf5021adc6c6'
 servers:
   - url: 'https://us.api.konghq.com/v2'
     description: United-States Production region

api-specs/konnect/api-builder/v3/openapi.yaml

@@ -1,11 +1,13 @@
 openapi: 3.0.3
 info:
   title: Konnect API Builder
-  version: 3.0.25
+  version: 3.0.26
   description: The management API for building APIs for Konnect Dev Portals.
   contact:
     name: Kong
     url: 'https://cloud.konghq.com'
+  x-oas-source: kong/platform-api@3a23fcee8d40e0fce64d7cfb28d51c270a2b9e28
+  x-oas-source-link: 'https://github.com/Kong/platform-api/commit/3a23fcee8d40e0fce64d7cfb28d51c270a2b9e28'
 servers:
   - url: 'https://us.api.konghq.com/v3'
     description: United-States Production region
@@ -531,6 +533,7 @@ paths:
         - $ref: '#/components/parameters/PageSize'
         - $ref: '#/components/parameters/PageNumber'
         - $ref: '#/components/parameters/ApiVersionFilters'
+        - $ref: '#/components/parameters/ApiVersionSort'
       responses:
         '200':
           $ref: '#/components/responses/ListApiVersionResponse'
@@ -917,6 +920,15 @@ components:
       schema:
         $ref: '#/components/schemas/ApiVersionFilterParameters'
       style: deepObject
+    ApiVersionSort:
+      name: sort
+      description: |
+        Sorts a collection of API versions. Supported sort attributes are:
+          - created_at
+      required: false
+      in: query
+      schema:
+        $ref: '#/components/schemas/SortQuery'
     DocumentId:
       schema:
         type: string
@@ -1683,8 +1695,19 @@ components:
         updated_at:
           $ref: '#/components/schemas/DateTimeFieldFilter'
       title: API Attribute Filter Parameters
-    StringFieldEqualsFilter:
-      description: Filters on the given string field value by exact match.
+    UuidFieldFilter:
+      description: 'Filter using **one** of the following operators: `oeq`, `neq`'
+      type: object
+      properties:
+        oeq:
+          description: The field matches any of the provided values.
+          type: string
+          example: '?filter[field_name_here][oeq]=foo,bar'
+        neq:
+          description: The field does not match the provided value.
+          type: string
+          example: '?filter[field_name_here][neq]=bar'
+      additionalProperties: false
       oneOf:
         - type: string
         - type: object
@@ -1695,99 +1718,51 @@ components:
               type: string
           required:
             - eq
-      title: StringFieldEqualsFilter
-      x-examples:
-        example-1: equals-some-value
-        example-2:
-          eq: some-value
-    StringFieldOEQFilter:
-      description: Returns entities that exact match any of the comma-delimited phrases in the filter string.
-      type: object
-      properties:
-        oeq:
-          type: string
-      additionalProperties: false
-      required:
-        - oeq
-      title: StringFieldOEQFilter
       x-examples:
         example-1:
           oeq: 'some-value,some-other-value'
-    StringFieldNEQFilter:
-      description: Filters on the given string field value by exact match inequality.
-      type: object
-      properties:
-        neq:
-          type: string
-      additionalProperties: false
-      required:
-        - neq
-      title: StringFieldNEQFilter
-      x-examples:
-        example-1:
           neq: not-this-value
-    UuidFieldFilter:
-      description: Filters on the given UUID field value by exact match.
-      oneOf:
-        - $ref: '#/components/schemas/StringFieldEqualsFilter'
-        - $ref: '#/components/schemas/StringFieldOEQFilter'
-        - $ref: '#/components/schemas/StringFieldNEQFilter'
-      title: UuidFieldFilter
-      x-examples:
-        example-1: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
         example-2:
-          eq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
-        example-3:
-          oeq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
-        example-4:
-          neq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
-    StringFieldContainsFilter:
-      description: Filters on the given string field value by fuzzy match.
+          eq: some-value
+    StringFieldFilter:
+      description: 'Filter using **one** of the following operators: `oeq`, `neq`, `contains`, `ocontains`'
       type: object
       properties:
         contains:
+          description: The field contains the provided value.
           type: string
-      additionalProperties: false
-      required:
-        - contains
-      title: StringFieldContainsFilter
-      x-examples:
-        example-1:
-          contains: some-value
-    StringFieldOContainsFilter:
-      description: Returns entities that fuzzy-match any of the comma-delimited phrases in the filter string.
-      type: object
-      properties:
+          example: '?filter[field_name_here][contains]=foo'
         ocontains:
+          description: The field contains any of the provided values.
+          type: string
+          example: '?filter[field_name_here][ocontains]=foo,bar'
+        oeq:
+          description: The field matches any of the provided values.
+          type: string
+          example: '?filter[field_name_here][oeq]=foo,bar'
+        neq:
+          description: The field does not match the provided value.
           type: string
+          example: '?filter[field_name_here][neq]=bar'
       additionalProperties: false
-      required:
-        - ocontains
-      title: StringFieldOContainsFilter
+      oneOf:
+        - type: string
+        - type: object
+          title: StringFieldEqualsComparison
+          additionalProperties: false
+          properties:
+            eq:
+              type: string
+          required:
+            - eq
       x-examples:
         example-1:
+          contains: some-value
           ocontains: 'this-value,or-that-value'
-    StringFieldFilter:
-      description: Filters on the given string field value by either exact or fuzzy match.
-      oneOf:
-        - $ref: '#/components/schemas/StringFieldEqualsFilter'
-        - $ref: '#/components/schemas/StringFieldContainsFilter'
-        - $ref: '#/components/schemas/StringFieldOContainsFilter'
-        - $ref: '#/components/schemas/StringFieldOEQFilter'
-        - $ref: '#/components/schemas/StringFieldNEQFilter'
-      title: StringFieldFilter
-      x-examples:
-        example-1: equals-some-value
+          oeq: 'some-value,some-other-value'
+          neq: not-this-value
         example-2:
           eq: some-value
-        example-3:
-          contains: some-value
-        example-4:
-          ocontains: 'some-potential,value'
-        example-5:
-          oeq: 'some-potential,value'
-        example-6:
-          neq: not-this-value
     LabelsFieldFilter:
       allOf:
         - title: LabelsFieldFilter

api-specs/konnect/api-products/v2/openapi.yaml

@@ -6,6 +6,8 @@ info:
   contact:
     name: Kong
     url: 'https://cloud.konghq.com'
+  x-oas-source: kong/platform-api@3a23fcee8d40e0fce64d7cfb28d51c270a2b9e28
+  x-oas-source-link: 'https://github.com/Kong/platform-api/commit/3a23fcee8d40e0fce64d7cfb28d51c270a2b9e28'
 servers:
   - url: 'https://us.api.konghq.com/v2'
     description: United-States Production region
@@ -1367,8 +1369,27 @@ components:
       required:
         - id
         - control_plane_id
-    StringFieldEqualsFilter:
-      description: Filters on the given string field value by exact match.
+    StringFieldFilter:
+      description: 'Filter using **one** of the following operators: `oeq`, `neq`, `contains`, `ocontains`'
+      type: object
+      properties:
+        contains:
+          description: The field contains the provided value.
+          type: string
+          example: '?filter[field_name_here][contains]=foo'
+        ocontains:
+          description: The field contains any of the provided values.
+          type: string
+          example: '?filter[field_name_here][ocontains]=foo,bar'
+        oeq:
+          description: The field matches any of the provided values.
+          type: string
+          example: '?filter[field_name_here][oeq]=foo,bar'
+        neq:
+          description: The field does not match the provided value.
+          type: string
+          example: '?filter[field_name_here][neq]=bar'
+      additionalProperties: false
       oneOf:
         - type: string
         - type: object
@@ -1379,84 +1400,14 @@ components:
               type: string
           required:
             - eq
-      title: StringFieldEqualsFilter
-      x-examples:
-        example-1: equals-some-value
-        example-2:
-          eq: some-value
-    StringFieldContainsFilter:
-      description: Filters on the given string field value by fuzzy match.
-      type: object
-      properties:
-        contains:
-          type: string
-      additionalProperties: false
-      required:
-        - contains
-      title: StringFieldContainsFilter
       x-examples:
         example-1:
           contains: some-value
-    StringFieldOContainsFilter:
-      description: Returns entities that fuzzy-match any of the comma-delimited phrases in the filter string.
-      type: object
-      properties:
-        ocontains:
-          type: string
-      additionalProperties: false
-      required:
-        - ocontains
-      title: StringFieldOContainsFilter
-      x-examples:
-        example-1:
           ocontains: 'this-value,or-that-value'
-    StringFieldOEQFilter:
-      description: Returns entities that exact match any of the comma-delimited phrases in the filter string.
-      type: object
-      properties:
-        oeq:
-          type: string
-      additionalProperties: false
-      required:
-        - oeq
-      title: StringFieldOEQFilter
-      x-examples:
-        example-1:
           oeq: 'some-value,some-other-value'
-    StringFieldNEQFilter:
-      description: Filters on the given string field value by exact match inequality.
-      type: object
-      properties:
-        neq:
-          type: string
-      additionalProperties: false
-      required:
-        - neq
-      title: StringFieldNEQFilter
-      x-examples:
-        example-1:
           neq: not-this-value
-    StringFieldFilter:
-      description: Filters on the given string field value by either exact or fuzzy match.
-      oneOf:
-        - $ref: '#/components/schemas/StringFieldEqualsFilter'
-        - $ref: '#/components/schemas/StringFieldContainsFilter'
-        - $ref: '#/components/schemas/StringFieldOContainsFilter'
-        - $ref: '#/components/schemas/StringFieldOEQFilter'
-        - $ref: '#/components/schemas/StringFieldNEQFilter'
-      title: StringFieldFilter
-      x-examples:
-        example-1: equals-some-value
         example-2:
           eq: some-value
-        example-3:
-          contains: some-value
-        example-4:
-          ocontains: 'some-potential,value'
-        example-5:
-          oeq: 'some-potential,value'
-        example-6:
-          neq: not-this-value
     SortQuery:
       description: |
         The `asc` suffix is optional as the default sort order is ascending.
@@ -2244,20 +2195,34 @@ components:
         - checked
         - type
     UuidFieldFilter:
-      description: Filters on the given UUID field value by exact match.
+      description: 'Filter using **one** of the following operators: `oeq`, `neq`'
+      type: object
+      properties:
+        oeq:
+          description: The field matches any of the provided values.
+          type: string
+          example: '?filter[field_name_here][oeq]=foo,bar'
+        neq:
+          description: The field does not match the provided value.
+          type: string
+          example: '?filter[field_name_here][neq]=bar'
+      additionalProperties: false
       oneOf:
-        - $ref: '#/components/schemas/StringFieldEqualsFilter'
-        - $ref: '#/components/schemas/StringFieldOEQFilter'
-        - $ref: '#/components/schemas/StringFieldNEQFilter'
-      title: UuidFieldFilter
+        - type: string
+        - type: object
+          title: StringFieldEqualsComparison
+          additionalProperties: false
+          properties:
+            eq:
+              type: string
+          required:
+            - eq
       x-examples:
-        example-1: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
+        example-1:
+          oeq: 'some-value,some-other-value'
+          neq: not-this-value
         example-2:
-          eq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
-        example-3:
-          oeq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
-        example-4:
-          neq: 3bbfd3a-e9ab-48a9-9881-ed589e4615d1
+          eq: some-value
     ConflictError:
       allOf:
         - $ref: '#/components/schemas/BaseError'