chore(docs): Updated API Reference (v2) (#9437)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/components/schemas/AdminPromotion.yaml

@@ -4,6 +4,13 @@ x-schemaName: AdminPromotion
 required:
   - id
 properties:
+  application_method:
+    type: object
+  rules:
+    type: array
+    description: The promotion's rules.
+    items:
+      $ref: ./AdminPromotionRule.yaml
   id:
     type: string
     title: id
@@ -12,6 +19,7 @@ properties:
     type: string
     title: code
     description: The promotion's code.
+    example: OFF50
   type:
     type: string
     description: The promotion's type.
@@ -21,17 +29,12 @@ properties:
   is_automatic:
     type: boolean
     title: is_automatic
-    description: The promotion's is automatic.
-  application_method:
-    $ref: ./BaseApplicationMethod.yaml
-  rules:
-    type: array
-    description: The promotion's rules.
-    items:
-      $ref: ./BasePromotionRule.yaml
+    description: >-
+      Whether the promotion is applied on a cart automatically if it matches the
+      promotion's rules.
   campaign_id:
     type: string
     title: campaign_id
-    description: The promotion's campaign id.
+    description: The ID of the campaign this promotion belongs to.
   campaign:
     $ref: ./AdminCampaign.yaml