docs: generate OAS with events (#12394)

* docs: generate OAS with events * small change
2025-05-07 14:57:03 +03:00
parent 262064fe96
commit a3bdb3e383
515 changed files with 3808 additions and 189 deletions
@@ -157,13 +157,21 @@ get:
        oneOf:
          - type: string
            title: province_code
-            description: Filter by a province code.
+            description: Filter by a ISO 3166-2 province code. Must be lower-case.
+            example: us-ca
+            externalDocs:
+              url: https://en.wikipedia.org/wiki/ISO_3166-2
+              description: Learn more about ISO 3166-2
          - type: array
-            description: Filter by province codes.
+            description: Filter by ISO 3166-2 province codes.
            items:
              type: string
              title: province_code
-              description: A province code.
+              description: A ISO 3166-2 province code.
+              example: us-ca
+              externalDocs:
+                url: https://en.wikipedia.org/wiki/ISO_3166-2
+                description: Learn more about ISO 3166-2
          - type: object
            description: Apply filters on the province code.
            properties:
@@ -1380,3 +1388,4 @@ post:
    '500':
      $ref: ../components/responses/500_error.yaml
  x-workflow: createTaxRegionsWorkflow
+  x-events: []