chore(docs): Generated API Reference (#3211)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>

docs/api/admin/components/schemas/Discount.yaml

@@ -3,11 +3,24 @@ description: Represents a discount that can be applied to a cart for promotional
 type: object
 required:
   - code
+  - created_at
+  - deleted_at
+  - ends_at
+  - id
+  - is_disabled
   - is_dynamic
+  - metadata
+  - parent_discount_id
+  - rule_id
+  - starts_at
+  - updated_at
+  - usage_count
+  - usage_limit
+  - valid_duration
 properties:
   id:
-    type: string
     description: The discount's ID
+    type: string
     example: disc_01F0YESMW10MGHWJKZSDDMN0VN
   code:
     description: >-
@@ -22,11 +35,13 @@ properties:
     type: boolean
     example: false
   rule_id:
-    type: string
     description: The Discount Rule that governs the behaviour of the Discount
+    nullable: true
+    type: string
     example: dru_01F0YESMVK96HVX7N419E3CJ7C
   rule:
     description: Available if the relation `rule` is expanded.
+    nullable: true
     $ref: ./DiscountRule.yaml
   is_disabled:
     description: >-
@@ -35,13 +50,15 @@ properties:
     type: boolean
     example: false
   parent_discount_id:
-    type: string
     description: >-
       The Discount that the discount was created from. This will always be a
       dynamic discount
+    nullable: true
+    type: string
     example: disc_01G8ZH853YPY9B94857DY91YGW
   parent_discount:
     description: Available if the relation `parent_discount` is expanded.
+    nullable: true
     $ref: ./Discount.yaml
   starts_at:
     description: The time at which the discount can be used.
@@ -49,11 +66,13 @@ properties:
     format: date-time
   ends_at:
     description: The time at which the discount can no longer be used.
+    nullable: true
     type: string
     format: date-time
   valid_duration:
-    type: string
     description: Duration the discount runs between
+    nullable: true
+    type: string
     example: P3Y6M4DT12H30M5S
   regions:
     description: >-
@@ -61,10 +80,10 @@ properties:
       `regions` is expanded.
     type: array
     items:
-      type: object
-      description: A region object.
+      $ref: ./Region.yaml
   usage_limit:
     description: The maximum number of times that a discount can be used.
+    nullable: true
     type: integer
     example: 100
   usage_count:
@@ -73,19 +92,21 @@ properties:
     example: 50
     default: 0
   created_at:
-    type: string
     description: The date with timezone at which the resource was created.
+    type: string
     format: date-time
   updated_at:
-    type: string
     description: The date with timezone at which the resource was updated.
+    type: string
     format: date-time
   deleted_at:
-    type: string
     description: The date with timezone at which the resource was deleted.
+    nullable: true
+    type: string
     format: date-time
   metadata:
-    type: object
     description: An optional key-value map with additional details
+    nullable: true
+    type: object
     example:
       car: white