chore(docs): Updated API Reference (automated) (medusajs#12826)

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

Co-authored-by: Oli Juhl <[email protected]>
Co-authored-by: Shahed Nasser <[email protected]>

Author: 3 people

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_products_imports/post.js

@@ -0,0 +1,16 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
+  debug: import.meta.env.DEV,
+  auth: {
+    type: "session",
+  },
+})
+
+sdk.admin.product.createImport({
+  file // uploaded File instance
+})
+.then(({ transaction_id }) => {
+  console.log(transaction_id)
+})

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_products_imports_{transaction_id}_confirm/post.js

@@ -0,0 +1,14 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
+  debug: import.meta.env.DEV,
+  auth: {
+    type: "session",
+  },
+})
+
+sdk.admin.product.confirmImport("transaction_123")
+.then(() => {
+  console.log("Import confirmed")
+})

www/apps/api-reference/specs/admin/code_samples/JavaScript/admin_uploads_presigned-urls/post.js

@@ -0,0 +1,15 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
+  debug: import.meta.env.DEV,
+  auth: {
+    type: "session",
+  },
+})
+
+sdk.admin.upload.presignedUrl({
+  name: "test.txt",
+  size: 1000,
+  type: "text/plain",
+}))

www/apps/api-reference/specs/admin/code_samples/Shell/admin_products_imports/post.sh

@@ -0,0 +1,10 @@
+curl -X POST '{backend_url}/admin/products/imports' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "file_key": "{value}",
+  "originalname": "{value}",
+  "extension": "{value}",
+  "size": 38,
+  "mime_type": "{value}"
+}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_products_imports_{transaction_id}_confirm/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/products/imports/{transaction_id}/confirm' \
+-H 'Authorization: Bearer {access_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_uploads_presigned-urls/post.sh

@@ -0,0 +1,8 @@
+curl -X POST '{backend_url}/admin/uploads/presigned-urls' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "originalname": "{value}",
+  "size": 43,
+  "mime_type": "{value}"
+}'

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

@@ -40,6 +40,7 @@ required:
   - original_shipping_total
   - original_shipping_subtotal
   - original_shipping_tax_total
+  - credit_line_total
 properties:
   payment_collections:
     type: array
@@ -254,3 +255,7 @@ properties:
     description: The draft order's credit lines.
     items:
       $ref: ./OrderCreditLine.yaml
+  credit_line_total:
+    type: number
+    title: credit_line_total
+    description: The draft order's credit line total.

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

@@ -40,6 +40,7 @@ required:
   - original_shipping_total
   - original_shipping_subtotal
   - original_shipping_tax_total
+  - credit_line_total
 properties:
   return_requested_total:
     type: number
@@ -653,3 +654,7 @@ properties:
     description: The order preview's credit lines.
     items:
       $ref: ./OrderCreditLine.yaml
+  credit_line_total:
+    type: number
+    title: credit_line_total
+    description: The draft order preview's credit line total.

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

@@ -0,0 +1,32 @@
+type: object
+description: The details of the product's import file.
+x-schemaName: AdminImportProducts
+required:
+  - file_key
+  - originalname
+  - extension
+  - size
+  - mime_type
+properties:
+  file_key:
+    type: string
+    title: file_key
+    description: The name of the file as stored in the configured File Module Provider.
+  originalname:
+    type: string
+    title: originalname
+    description: The file's original name.
+  extension:
+    type: string
+    title: extension
+    description: The file's extension.
+    example: csv
+  size:
+    type: number
+    title: size
+    description: The file's size in bytes.
+  mime_type:
+    type: string
+    title: mime_type
+    description: The file's mime type.
+    example: text/csv

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

@@ -40,6 +40,7 @@ required:
   - original_shipping_total
   - original_shipping_subtotal
   - original_shipping_tax_total
+  - credit_line_total
 properties:
   payment_collections:
     type: array
@@ -247,3 +248,7 @@ properties:
     description: The order's credit lines.
     items:
       $ref: ./OrderCreditLine.yaml
+  credit_line_total:
+    type: number
+    title: credit_line_total
+    description: The order's credit line total.