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

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

docs/api/admin/code_samples/JavaScript/admin_draft-orders_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.update(draft_order_id, {
+  email: "user@example.com"
+})
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/auth/deleteundefined

@@ -0,0 +1,4 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.auth.deleteSession()

docs/api/admin/code_samples/JavaScript/auth/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.auth.getSession()
+.then(({ user }) => {
+  console.log(user.id);
+});

docs/api/admin/code_samples/JavaScript/auth/postundefined

@@ -0,0 +1,8 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+medusa.admin.auth.createSession({
+  email: 'user@example.com',
+  password: 'supersecret'
+}).then((({ user }) => {
+  console.log(user.id);
+});

docs/api/admin/code_samples/JavaScript/batch-jobs/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.batchJobs.list()
+.then(({ batch_jobs, limit, offset, count }) => {
+  console.log(batch_jobs.length);
+});

docs/api/admin/code_samples/JavaScript/batch-jobs/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.batchJobs.create({
+  type: 'product-export',
+  context: {},
+  dry_run: false
+}).then((({ batch_job }) => {
+  console.log(batch_job.id);
+});

docs/api/admin/code_samples/JavaScript/batch-jobs_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.batchJobs.retrieve(batch_job_id)
+.then(({ batch_job }) => {
+  console.log(batch_job.id);
+});

docs/api/admin/code_samples/JavaScript/batch-jobs_{id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.batchJobs.cancel(batch_job_id)
+.then(({ batch_job }) => {
+  console.log(batch_job.id);
+});

docs/api/admin/code_samples/JavaScript/batch-jobs_{id}_confirm/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.batchJobs.confirm(batch_job_id)
+.then(({ batch_job }) => {
+  console.log(batch_job.id);
+});

docs/api/admin/code_samples/JavaScript/collections/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.collections.list()
+.then(({ collections, limit, offset, count }) => {
+  console.log(collections.length);
+});

docs/api/admin/code_samples/JavaScript/collections/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.collections.create({
+  title: 'New Collection'
+})
+.then(({ collection }) => {
+  console.log(collection.id);
+});

docs/api/admin/code_samples/JavaScript/collections_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.collections.delete(collection_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/collections_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.collections.retrieve(collection_id)
+.then(({ collection }) => {
+  console.log(collection.id);
+});

docs/api/admin/code_samples/JavaScript/collections_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.collections.update(collection_id, {
+  title: 'New Collection'
+})
+.then(({ collection }) => {
+  console.log(collection.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.list()
+.then(({ customer_groups, limit, offset, count }) => {
+  console.log(customer_groups.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.create({
+  name: 'VIP'
+})
+.then(({ customer_group }) => {
+  console.log(customer_group.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.delete(customer_group_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.retrieve(customer_group_id)
+.then(({ customer_group }) => {
+  console.log(customer_group.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.update(customer_group_id, {
+  name: 'VIP'
+})
+.then(({ customer_group }) => {
+  console.log(customer_group.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}_customers/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.listCustomers(customer_group_id)
+.then(({ customers }) => {
+  console.log(customers.length);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}_customers_batch/deleteundefined

@@ -0,0 +1,13 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.removeCustomers(customer_group_id, {
+  customer_ids: [
+    {
+      id: customer_id
+    }
+  ]
+})
+.then(({ customer_group }) => {
+  console.log(customer_group.id);
+});

docs/api/admin/code_samples/JavaScript/customer-groups_{id}_customers_batch/postundefined

@@ -0,0 +1,13 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customerGroups.addCustomers(customer_group_id, {
+  customer_ids: [
+    {
+      id: customer_id
+    }
+  ]
+})
+.then(({ customer_group }) => {
+  console.log(customer_group.id);
+});

docs/api/admin/code_samples/JavaScript/customers/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customers.list()
+.then(({ customers, limit, offset, count }) => {
+  console.log(customers.length);
+});

docs/api/admin/code_samples/JavaScript/customers/postundefined

@@ -0,0 +1,12 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customers.create({
+  email: 'user@example.com',
+  first_name: 'Caterina',
+  last_name: 'Yost',
+  password: 'supersecret'
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

docs/api/admin/code_samples/JavaScript/customers_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customers.retrieve(customer_id)
+.then(({ customer }) => {
+  console.log(customer.id);
+});

docs/api/admin/code_samples/JavaScript/customers_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.customers.update(customer_id, {
+  first_name: 'Dolly'
+})
+.then(({ customer }) => {
+  console.log(customer.id);
+});

docs/api/admin/code_samples/JavaScript/discounts/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.list()
+.then(({ discounts, limit, offset, count }) => {
+  console.log(discounts.id);
+});

docs/api/admin/code_samples/JavaScript/discounts/postundefined

@@ -0,0 +1,17 @@
+import Medusa from "@medusajs/medusa-js"
+import { AllocationType, DiscountRuleType } from "@medusajs/medusa"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.create({
+  code: 'TEST',
+  rule: {
+    type: DiscountRuleType.FIXED,
+    value: 10,
+    allocation: AllocationType.ITEM
+  },
+  is_dynamic: false,
+  is_disabled: false
+})
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_code_{code}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.retrieveByCode(code)
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{discount_id}_conditions/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+import { DiscountConditionOperator } from "@medusajs/medusa"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.createCondition(discount_id, {
+  operator: DiscountConditionOperator.IN
+})
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{discount_id}_conditions_{condition_id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.deleteCondition(discount_id, condition_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{discount_id}_conditions_{condition_id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.getCondition(discount_id, condition_id)
+.then(({ discount_condition }) => {
+  console.log(discount_condition.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{discount_id}_conditions_{condition_id}/postundefined

@@ -0,0 +1,11 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.updateCondition(discount_id, condition_id, {
+  products: [
+    product_id
+  ]
+})
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.delete(discount_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.retrieve(discount_id)
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.update(discount_id, {
+  code: 'TEST'
+})
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}_dynamic-codes/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.createDynamicCode(discount_id, {
+  code: 'TEST',
+  usage_limit: 1
+})
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}_dynamic-codes_{code}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.deleteDynamicCode(discount_id, code)
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}_regions_{region_id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.removeRegion(discount_id, region_id)
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/discounts_{id}_regions_{region_id}/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.discounts.addRegion(discount_id, region_id)
+.then(({ discount }) => {
+  console.log(discount.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.list()
+.then(({ draft_orders, limit, offset, count }) => {
+  console.log(draft_orders.length);
+});

docs/api/admin/code_samples/JavaScript/draft-orders/postundefined

@@ -0,0 +1,20 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.create({
+  email: 'user@example.com',
+  region_id,
+  items: [
+    {
+      quantity: 1
+    }
+  ],
+  shipping_methods: [
+    {
+      option_id
+    }
+  ],
+})
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.delete(draft_order_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.retrieve(draft_order_id)
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}_line-items/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.addLineItem(draft_order_id, {
+  quantity: 1
+})
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}_line-items_{line_id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.removeLineItem(draft_order_id, item_id)
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}_line-items_{line_id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.updateLineItem(draft_order_id, line_id, {
+  quantity: 1
+})
+.then(({ draft_order }) => {
+  console.log(draft_order.id);
+});

docs/api/admin/code_samples/JavaScript/draft-orders_{id}_pay/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.draftOrders.markPaid(draft_order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/gift-cards/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.giftCards.list()
+.then(({ gift_cards, limit, offset, count }) => {
+  console.log(gift_cards.length);
+});

docs/api/admin/code_samples/JavaScript/gift-cards/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.giftCards.create({
+  region_id
+})
+.then(({ gift_card }) => {
+  console.log(gift_card.id);
+});

docs/api/admin/code_samples/JavaScript/gift-cards_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.giftCards.delete(gift_card_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/gift-cards_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.giftCards.retrieve(gift_card_id)
+.then(({ gift_card }) => {
+  console.log(gift_card.id);
+});

docs/api/admin/code_samples/JavaScript/gift-cards_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.giftCards.update(gift_card_id, {
+  region_id
+})
+.then(({ gift_card }) => {
+  console.log(gift_card.id);
+});

docs/api/admin/code_samples/JavaScript/invites/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.invites.list()
+.then(({ invites }) => {
+  console.log(invites.length);
+});

docs/api/admin/code_samples/JavaScript/invites/postundefined

@@ -0,0 +1,13 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.invites.create({
+  user: "user@example.com",
+  role: "admin"
+})
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // an error occurred
+});

docs/api/admin/code_samples/JavaScript/invites_accept/postundefined

@@ -0,0 +1,17 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.invites.accept({
+  token,
+  user: {
+    first_name: 'Brigitte',
+    last_name: 'Collier',
+    password: 'supersecret'
+  }
+})
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // an error occurred
+});

docs/api/admin/code_samples/JavaScript/invites_{invite_id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.invites.delete(invite_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/invites_{invite_id}_resend/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.invites.resend(invite_id)
+.then(() => {
+  // successful
+})
+.catch(() => {
+  // an error occurred
+});

docs/api/admin/code_samples/JavaScript/notes/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notes.list()
+.then(({ notes, limit, offset, count }) => {
+  console.log(notes.length);
+});

docs/api/admin/code_samples/JavaScript/notes/postundefined

@@ -0,0 +1,11 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notes.create({
+  resource_id,
+  resource_type: 'order',
+  value: 'We delivered this order'
+})
+.then(({ note }) => {
+  console.log(note.id);
+});

docs/api/admin/code_samples/JavaScript/notes_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notes.delete(note_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/notes_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notes.retrieve(note_id)
+.then(({ note }) => {
+  console.log(note.id);
+});

docs/api/admin/code_samples/JavaScript/notes_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notes.update(note_id, {
+ value: 'We delivered this order'
+})
+.then(({ note }) => {
+  console.log(note.id);
+});

docs/api/admin/code_samples/JavaScript/notifications/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notifications.list()
+.then(({ notifications }) => {
+  console.log(notifications.length);
+});

docs/api/admin/code_samples/JavaScript/notifications_{id}_resend/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.notifications.resend(notification_id)
+.then(({ notification }) => {
+  console.log(notification.id);
+});

docs/api/admin/code_samples/JavaScript/order_{id}_claims/postundefined

@@ -0,0 +1,15 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createClaim(order_id, {
+  type: 'refund',
+  claim_items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ]
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/order_{id}_claims_{claim_id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.updateClaim(order_id, claim_id, {
+  no_notification: true
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/order_{id}_swaps/postundefined

@@ -0,0 +1,14 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createSwap(order_id, {
+  return_items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ]
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.list()
+.then(({ orders, limit, offset, count }) => {
+  console.log(orders.length);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.retrieve(order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.update(order_id, {
+  email: 'user@example.com'
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_archive/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.archive(order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancel(order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_capture/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.capturePayment(order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_claims_{claim_id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancelClaim(order_id, claim_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_claims_{claim_id}_fulfillments/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.fulfillClaim(order_id, claim_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_claims_{claim_id}_fulfillments_{fulfillment_id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancelClaimFulfillment(order_id, claim_id, fulfillment_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_claims_{claim_id}_shipments/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createClaimShipment(order_id, claim_id, {
+  fulfillment_id
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_complete/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.complete(order_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_fulfillment/postundefined

@@ -0,0 +1,14 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createFulfillment(order_id, {
+  items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ]
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_fulfillments_{fulfillment_id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancelFulfillment(order_id, fulfillment_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_refund/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.refundPayment(order_id, {
+  amount: 1000,
+  reason: 'Do not like it'
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_return/postundefined

@@ -0,0 +1,14 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.requestReturn(order_id, {
+  items: [
+    {
+      item_id,
+      quantity: 1
+    }
+  ]
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_shipment/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createShipment(order_id, {
+  fulfillment_id
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_shipping-methods/postundefined

@@ -0,0 +1,10 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.addShippingMethod(order_id, {
+  price: 1000,
+  option_id
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_swaps_{swap_id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancelSwap(order_id, swap_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_swaps_{swap_id}_fulfillments/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.fulfillSwap(order_id, swap_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_swaps_{swap_id}_fulfillments_{fulfillment_id}_cancel/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.cancelSwapFulfillment(order_id, swap_id, fulfillment_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_swaps_{swap_id}_process-payment/postundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.processSwapPayment(order_id, swap_id)
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/orders_{id}_swaps_{swap_id}_shipments/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.orders.createSwapShipment(order_id, swap_id, {
+  fulfillment_id
+})
+.then(({ order }) => {
+  console.log(order.id);
+});

docs/api/admin/code_samples/JavaScript/price-lists/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.list()
+.then(({ price_lists, limit, offset, count }) => {
+  console.log(price_lists.length);
+});

docs/api/admin/code_samples/JavaScript/price-lists/postundefined

@@ -0,0 +1,19 @@
+import Medusa from "@medusajs/medusa-js"
+import { PriceListType } from "@medusajs/medusa"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.create({
+  name: 'New Price List',
+  description: 'A new price list',
+  type: PriceListType.SALE,
+  prices: [
+    {
+      amount: 1000,
+      variant_id,
+      currency_code: 'eur'
+    }
+  ]
+})
+.then(({ price_list }) => {
+  console.log(price_list.id);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}/deleteundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.delete(price_list_id)
+.then(({ id, object, deleted }) => {
+  console.log(id);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.retrieve(price_list_id)
+.then(({ price_list }) => {
+  console.log(price_list.id);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}/postundefined

@@ -0,0 +1,9 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.update(price_list_id, {
+  name: 'New Price List'
+})
+.then(({ price_list }) => {
+  console.log(price_list.id);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}_prices_batch/deleteundefined

@@ -0,0 +1,11 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.deletePrices(price_list_id, {
+  price_ids: [
+    price_id
+  ]
+})
+.then(({ ids, object, deleted }) => {
+  console.log(ids.length);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}_prices_batch/postundefined

@@ -0,0 +1,15 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.addPrices(price_list_id, {
+  prices: [
+    {
+      amount: 1000,
+      variant_id,
+      currency_code: 'eur'
+    }
+  ]
+})
+.then(({ price_list }) => {
+  console.log(price_list.id);
+});

docs/api/admin/code_samples/JavaScript/price-lists_{id}_products/getundefined

@@ -0,0 +1,7 @@
+import Medusa from "@medusajs/medusa-js"
+const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
+// must be previously logged in or use api token
+medusa.admin.priceLists.listProducts(price_list_id)
+.then(({ products, limit, offset, count }) => {
+  console.log(products.length);
+});