chore(docs): Updated API Reference (v2)

www/apps/api-reference/specs/admin/code_samples/Shell/admin_orders_{id}_fulfillments_{fulfillment_id}_shipments/post.sh

@@ -4,8 +4,8 @@ curl -X POST '{backend_url}/admin/orders/{id}/fulfillments/{fulfillment_id}/ship
 --data-raw '{
   "items": [
     {
-      "id": "id_uHIzYcTxCHG",
-      "quantity": 3083340957614080
+      "id": "id_LNI7MlaiSujsAR",
+      "quantity": 216057904103424
     }
   ],
   "metadata": {}

www/apps/api-reference/specs/admin/code_samples/Shell/admin_orders_{id}_preview/get.sh

@@ -0,0 +1,2 @@
+curl '{backend_url}/admin/orders/{id}/preview' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_request-items/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/returns/{id}/request-items' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_request-items_{action_id}/delete.sh

@@ -0,0 +1,2 @@
+curl -X DELETE '{backend_url}/admin/returns/{id}/request-items/{action_id}' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_request-items_{action_id}/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/returns/{id}/request-items/{action_id}' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_request/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/returns/{id}/request' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_shipping-method/post.sh

@@ -0,0 +1,6 @@
+curl -X POST '{backend_url}/admin/returns/{id}/shipping-method' \
+-H 'x-medusa-access-token: {api_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "shipping_option_id": "{value}"
+}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_shipping-method_{action_id}/delete.sh

@@ -0,0 +1,2 @@
+curl -X DELETE '{backend_url}/admin/returns/{id}/shipping-method/{action_id}' \
+-H 'x-medusa-access-token: {api_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_returns_{id}_shipping-method_{action_id}/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/returns/{id}/shipping-method/{action_id}' \
+-H 'x-medusa-access-token: {api_token}'

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

@@ -0,0 +1,8 @@
+type: object
+description: SUMMARY
+x-schemaName: AdminPostReturnsConfirmRequestReqSchema
+properties:
+  no_notification:
+    type: boolean
+    title: no_notification
+    description: The return's no notification.

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

@@ -9,6 +9,10 @@ properties:
     type: string
     title: order_id
     description: The return's order id.
+  location_id:
+    type: string
+    title: location_id
+    description: The return's location id.
   description:
     type: string
     title: description
@@ -17,6 +21,10 @@ properties:
     type: string
     title: internal_note
     description: The return's internal note.
+  no_notification:
+    type: boolean
+    title: no_notification
+    description: The return's no notification.
   metadata:
     type: object
     description: The return's metadata.

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

@@ -0,0 +1,12 @@
+type: object
+description: SUMMARY
+x-schemaName: AdminPostReturnsRequestItemsActionReqSchema
+properties:
+  quantity:
+    type: number
+    title: quantity
+    description: The return's quantity.
+  internal_note:
+    type: string
+    title: internal_note
+    description: The return's internal note.

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

@@ -0,0 +1,33 @@
+type: object
+description: SUMMARY
+x-schemaName: AdminPostReturnsRequestItemsReqSchema
+properties:
+  items:
+    type: array
+    description: The return's items.
+    items:
+      type: object
+      description: The item's items.
+      required:
+        - id
+        - quantity
+      properties:
+        id:
+          type: string
+          title: id
+          description: The item's ID.
+        quantity:
+          type: number
+          title: quantity
+          description: The item's quantity.
+        description:
+          type: string
+          title: description
+          description: The item's description.
+        internal_note:
+          type: string
+          title: internal_note
+          description: The item's internal note.
+        metadata:
+          type: object
+          description: The item's metadata.

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

@@ -0,0 +1,15 @@
+type: object
+description: SUMMARY
+x-schemaName: AdminPostReturnsShippingActionReqSchema
+properties:
+  custom_price:
+    type: number
+    title: custom_price
+    description: The return's custom price.
+  internal_note:
+    type: string
+    title: internal_note
+    description: The return's internal note.
+  metadata:
+    type: object
+    description: The return's metadata.

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

@@ -0,0 +1,25 @@
+type: object
+description: SUMMARY
+x-schemaName: AdminPostReturnsShippingReqSchema
+required:
+  - shipping_option_id
+properties:
+  shipping_option_id:
+    type: string
+    title: shipping_option_id
+    description: The return's shipping option id.
+  custom_price:
+    type: number
+    title: custom_price
+    description: The return's custom price.
+  description:
+    type: string
+    title: description
+    description: The return's description.
+  internal_note:
+    type: string
+    title: internal_note
+    description: The return's internal note.
+  metadata:
+    type: object
+    description: The return's metadata.