chore(docs): merge changes from master (#3780)

* chore(docs): Generated API Reference (#3761) Co-authored-by: shahednasser <shahednasser@users.noreply.github.com> * docs: fix typo (#3771) --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: shahednasser <shahednasser@users.noreply.github.com> Co-authored-by: Andre Schweighofer <fidrelity@users.noreply.github.com>
2023-04-10 11:15:54 +03:00
parent 5280e1bdad
commit ae017c4657
46 changed files with 221 additions and 296 deletions
--- a/docs/api/admin/code_samples/JavaScript/admin_inventory-items/get.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_inventory-items/get.js
@@ -2,6 +2,6 @@ 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.inventoryItems.list()
-.then(({ inventory_items }) => {
+.then(({ inventory_items, count, offset, limit }) => {
  console.log(inventory_items.length);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_inventory-items/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_inventory-items/post.js
@@ -1,9 +1,8 @@
 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.inventoryItems.create(inventoryItemId, {
+medusa.admin.inventoryItems.create({
  variant_id: 'variant_123',
-  sku: "sku-123",
 })
 .then(({ inventory_item }) => {
  console.log(inventory_item.id);
--- a/docs/api/admin/code_samples/JavaScript/admin_inventory-items_{id}_location-levels/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_inventory-items_{id}_location-levels/post.js
@@ -2,7 +2,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.inventoryItems.createLocationLevel(inventoryItemId, {
-  location_id: 'sloc',
+  location_id: 'sloc_123',
  stocked_quantity: 10,
 })
 .then(({ inventory_item }) => {
--- a/docs/api/admin/code_samples/JavaScript/admin_orders_{id}_line-items_{line_item_id}_reserve/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_orders_{id}_line-items_{line_item_id}_reserve/post.js
@@ -1,9 +0,0 @@
-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.createReservation(order_id, line_item_id, {
-  location_id
-})
-.then(({ reservation }) => {
-  console.log(reservation.id);
-});
--- a/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/delete.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/delete.js
@@ -1,7 +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.productCategories.delete(product_category_id)
+medusa.admin.productCategories.delete(productCategoryId)
 .then(({ id, object, deleted }) => {
  console.log(id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/get.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/get.js
@@ -1,7 +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.productCategories.retrieve(product_category_id)
+medusa.admin.productCategories.retrieve(productCategoryId)
 .then(({ product_category }) => {
  console.log(product_category.id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}/post.js
@@ -1,7 +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.productCategories.update(product_category_id, {
+medusa.admin.productCategories.update(productCategoryId, {
  name: "Skinny Jeans"
 })
 .then(({ product_category }) => {
--- a/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}_products_batch/delete.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}_products_batch/delete.js
@@ -1,10 +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.productCategories.removeProducts(product_category_id, {
+medusa.admin.productCategories.removeProducts(productCategoryId, {
  product_ids: [
    {
-      id: product_id
+      id: productId
    }
  ]
 })
--- a/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}_products_batch/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_product-categories_{id}_products_batch/post.js
@@ -1,10 +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.productCategories.addProducts(product_category_id, {
+medusa.admin.productCategories.addProducts(productCategoryId, {
  product_ids: [
    {
-      id: product_id
+      id: productId
    }
  ]
 })
--- a/docs/api/admin/code_samples/JavaScript/admin_orders_{id}_reservations/get.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_orders_{id}_reservations/get.js
@@ -1,7 +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.retrieveReservations(order_id)
-.then(({ reservations }) => {
-  console.log(reservations[0].id);
-});
+medusa.admin.reservations.list()
+.then(({ reservations, count, limit, offset }) => {
+  console.log(reservations.length)
+})
--- a/docs/api/admin/code_samples/JavaScript/admin_reservations/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_reservations/post.js
@@ -2,7 +2,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.reservations.create({
+  line_item_id: 'item_123',
+  location_id: 'loc_123',
+  inventory_item_id: 'iitem_123',
+  quantity: 1
 })
-.then(({ reservations }) => {
-  console.log(reservations.id);
+.then(({ reservation }) => {
+  console.log(reservation.id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/delete.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/delete.js
@@ -1,7 +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.reservations.delete(reservation.id)
+medusa.admin.reservations.delete(reservationId)
 .then(({ id, object, deleted }) => {
  console.log(id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/get.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/get.js
@@ -1,7 +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.reservations.retrieve(reservation_id)
+medusa.admin.reservations.retrieve(reservationId)
 .then(({ reservation }) => {
  console.log(reservation.id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_reservations_{id}/post.js
@@ -1,9 +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.reservations.update(reservation.id, {
+medusa.admin.reservations.update(reservationId, {
  quantity: 3
 })
-.then(({ reservations }) => {
-  console.log(reservations.id);
+.then(({ reservation }) => {
+  console.log(reservation.id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_sales-channels_{id}_stock-locations/delete.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_sales-channels_{id}_stock-locations/delete.js
@@ -1,8 +1,8 @@
 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.salesChannels.removeLocation(sales_channel_id, {
-  location_id: 'App'
+medusa.admin.salesChannels.removeLocation(salesChannelId, {
+  location_id: 'loc_id'
 })
 .then(({ sales_channel }) => {
  console.log(sales_channel.id);
--- a/docs/api/admin/code_samples/JavaScript/admin_sales-channels_{id}_stock-locations/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_sales-channels_{id}_stock-locations/post.js
@@ -1,8 +1,8 @@
 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.salesChannels.addLocation(sales_channel_id, {
-  location_id: 'App'
+medusa.admin.salesChannels.addLocation(salesChannelId, {
+  location_id: 'loc_123'
 })
 .then(({ sales_channel }) => {
  console.log(sales_channel.id);
--- a/docs/api/admin/code_samples/JavaScript/admin_stock-locations/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_stock-locations/post.js
@@ -3,7 +3,6 @@ const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
 // must be previously logged in or use api token
 medusa.admin.stockLocations.create({
  name: 'Main Warehouse',
-  location_id: 'sloc'
 })
 .then(({ stock_location }) => {
  console.log(stock_location.id);
--- a/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/delete.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/delete.js
@@ -2,6 +2,6 @@ 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.stockLocations.delete(stock_location_id)
-  .then(({ id, object, deleted }) => {
-    console.log(id)
-  })
+.then(({ id, object, deleted }) => {
+  console.log(id)
+})
--- a/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/get.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/get.js
@@ -1,7 +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.stockLocations.retrieve(stock_location_id)
+medusa.admin.stockLocations.retrieve(stockLocationId)
 .then(({ stock_location }) => {
  console.log(stock_location.id);
 });
--- a/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/post.js
+++ b/docs/api/admin/code_samples/JavaScript/admin_stock-locations_{id}/post.js
@@ -1,8 +1,8 @@
 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.stockLocations.update(stock_location_id, {
-  name: 'App'
+medusa.admin.stockLocations.update(stockLocationId, {
+  name: 'Main Warehouse'
 })
 .then(({ stock_location }) => {
  console.log(stock_location.id);
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items/get.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items/get.sh
@@ -1,3 +1,2 @@
 curl --location --request GET 'https://medusa-url.com/admin/inventory-items' \
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json'
+--header 'Authorization: Bearer {api_token}'
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items/post.sh
@@ -3,5 +3,4 @@ curl --location --request POST 'https://medusa-url.com/admin/inventory-items' \
 --header 'Content-Type: application/json' \
 --data-raw '{
    "variant_id": "variant_123",
-    "sku": "sku-123",
 }'
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}/get.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}/get.sh
@@ -1,3 +1,2 @@
 curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}' \
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json'
+--header 'Authorization: Bearer {api_token}'
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels/get.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels/get.sh
@@ -1,3 +1,2 @@
 curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}/location-levels' \
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json'
+--header 'Authorization: Bearer {api_token}'
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels/post.sh
@@ -2,6 +2,6 @@ curl --location --request POST 'https://medusa-url.com/admin/inventory-items/{id
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "location_id": "sloc",
+    "location_id": "sloc_123",
    "stocked_quantity": 10
 }'
--- a/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels_{location_id}/delete.sh
+++ b/docs/api/admin/code_samples/Shell/admin_inventory-items_{id}_location-levels_{location_id}/delete.sh
@@ -1,3 +1,2 @@
 curl --location --request DELETE 'https://medusa-url.com/admin/inventory-items/{id}/location-levels/{location_id}' \
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json'
+--header 'Authorization: Bearer {api_token}'
--- a/docs/api/admin/code_samples/Shell/admin_orders_{id}_line-items_{line_item_id}_reserve/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_orders_{id}_line-items_{line_item_id}_reserve/post.sh
@@ -1,4 +1,4 @@
-curl --location --request POST 'https://medusa-url.com/admin/orders/{id}/line-items/{line_item_id}/reservations' \
+curl --location --request POST 'https://medusa-url.com/admin/orders/{id}/line-items/{line_item_id}/reserve' \
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
--- a/docs/api/admin/code_samples/Shell/admin_product-categories_{id}_products_batch/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_product-categories_{id}_products_batch/post.sh
@@ -1,5 +1,5 @@
 curl --location \
--request POST 'https://medusa-url.com/admin/product-categories/{product_category_id}/products/batch' \
+--request POST 'https://medusa-url.com/admin/product-categories/{id}/products/batch' \
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
--- a/docs/api/admin/code_samples/Shell/admin_reservations/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_reservations/post.sh
@@ -2,7 +2,8 @@ curl --location --request POST 'https://medusa-url.com/admin/reservations' \
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "resource_id": "{resource_id}",
-    "resource_type": "order",
-    "value": "We delivered this order"
+    "line_item_id": "item_123",
+    "location_id": "loc_123",
+    "inventory_item_id": "iitem_123",
+    "quantity": 1
 }'
--- a/docs/api/admin/code_samples/Shell/admin_sales-channels_{id}_stock-locations/delete.sh
+++ b/docs/api/admin/code_samples/Shell/admin_sales-channels_{id}_stock-locations/delete.sh
@@ -2,5 +2,5 @@ curl --location --request DELETE 'https://medusa-url.com/admin/sales-channels/{i
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "locaton_id": "stock_location_id"
+    "locaton_id": "loc_id"
 }'
--- a/docs/api/admin/code_samples/Shell/admin_sales-channels_{id}_stock-locations/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_sales-channels_{id}_stock-locations/post.sh
@@ -2,5 +2,5 @@ curl --location --request POST 'https://medusa-url.com/admin/sales-channels/{id}
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "locaton_id": "stock_location_id"
+    "locaton_id": "loc_123"
 }'
--- a/docs/api/admin/code_samples/Shell/admin_stock-locations_{id}/post.sh
+++ b/docs/api/admin/code_samples/Shell/admin_stock-locations_{id}/post.sh
@@ -2,5 +2,5 @@ curl --location --request POST 'https://medusa-url.com/admin/stock-locations/{id
 --header 'Authorization: Bearer {api_token}' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "name": "App"
+    "name": "Main Warehouse"
 }'
--- a/docs/api/admin/paths/admin_inventory-items.yaml
+++ b/docs/api/admin/paths/admin_inventory-items.yaml
@@ -1,7 +1,9 @@
 get:
  operationId: GetInventoryItems
-  summary: List inventory items.
-  description: Lists inventory items.
+  summary: List Inventory Items
+  description: >-
+    Lists inventory items with the ability to apply filters or search queries on
+    them.
  x-authenticated: true
  parameters:
    - in: query
@@ -134,7 +136,7 @@ get:
      $ref: ../components/responses/500_error.yaml
 post:
  operationId: PostInventoryItems
-  summary: Create an Inventory Item.
+  summary: Create an Inventory Item
  description: Creates an Inventory Item.
  x-authenticated: true
  parameters:
--- a/docs/api/admin/paths/admin_inventory-items_{id}.yaml
+++ b/docs/api/admin/paths/admin_inventory-items_{id}.yaml
@@ -1,7 +1,7 @@
 get:
  operationId: GetInventoryItemsInventoryItem
-  summary: Retrive an Inventory Item.
-  description: Retrives an Inventory Item.
+  summary: Get an Inventory Item
+  description: Retrieves an Inventory Item.
  x-authenticated: true
  parameters:
    - in: path
@@ -58,7 +58,7 @@ get:
      $ref: ../components/responses/500_error.yaml
 post:
  operationId: PostInventoryItemsInventoryItem
-  summary: Update an Inventory Item.
+  summary: Update an Inventory Item
  description: Updates an Inventory Item.
  x-authenticated: true
  parameters:
--- a/docs/api/admin/paths/admin_inventory-items_{id}_location-levels.yaml
+++ b/docs/api/admin/paths/admin_inventory-items_{id}_location-levels.yaml
@@ -1,7 +1,7 @@
 get:
  operationId: GetInventoryItemsInventoryItemLocationLevels
-  summary: List stock levels of a given location.
-  description: Lists stock levels of a given location.
+  summary: List Inventory Levels
+  description: Lists inventory levels of an inventory item.
  x-authenticated: true
  parameters:
    - in: path
@@ -10,18 +10,6 @@ get:
      description: The ID of the Inventory Item.
      schema:
        type: string
-    - in: query
-      name: offset
-      description: How many stock locations levels to skip in the result.
-      schema:
-        type: integer
-        default: 0
-    - in: query
-      name: limit
-      description: Limit the number of stock locations levels returned.
-      schema:
-        type: integer
-        default: 20
    - in: query
      name: expand
      description: Comma separated list of relations to include in the results.
@@ -72,8 +60,8 @@ get:
      $ref: ../components/responses/500_error.yaml
 post:
  operationId: PostInventoryItemsInventoryItemLocationLevels
-  summary: Create an Inventory Location Level for a given Inventory Item.
-  description: Creates an Inventory Location Level for a given Inventory Item.
+  summary: Create an Inventory Level
+  description: Creates an Inventory Level for a given Inventory Item.
  x-authenticated: true
  parameters:
    - in: path
--- a/docs/api/admin/paths/admin_inventory-items_{id}_location-levels_{location_id}.yaml
+++ b/docs/api/admin/paths/admin_inventory-items_{id}_location-levels_{location_id}.yaml
@@ -1,7 +1,7 @@
 post:
  operationId: PostInventoryItemsInventoryItemLocationLevelsLocationLevel
-  summary: Update an Inventory Location Level for a given Inventory Item.
-  description: Updates an Inventory Location Level for a given Inventory Item.
+  summary: Update an Inventory Level
+  description: Updates an Inventory Level for a given Inventory Item.
  x-authenticated: true
  parameters:
    - in: path
@@ -72,7 +72,7 @@ post:
      $ref: ../components/responses/500_error.yaml
 delete:
  operationId: DeleteInventoryItemsInventoryIteLocationLevelsLocation
-  summary: Delete a location level of an Inventory Item.
+  summary: Delete a Location Level
  description: Delete a location level of an Inventory Item.
  x-authenticated: true
  parameters:
--- a/docs/api/admin/paths/admin_orders_{id}_line-items_{line_item_id}_reserve.yaml
+++ b/docs/api/admin/paths/admin_orders_{id}_line-items_{line_item_id}_reserve.yaml
@@ -24,11 +24,6 @@ post:
        schema:
          $ref: ../components/schemas/AdminOrdersOrderLineItemReservationReq.yaml
  x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: >-
-          ../code_samples/JavaScript/admin_orders_{id}_line-items_{line_item_id}_reserve/post.js
    - lang: Shell
      label: cURL
      source:
--- a/docs/api/admin/paths/admin_orders_{id}_reservations.yaml
+++ b/docs/api/admin/paths/admin_orders_{id}_reservations.yaml
@@ -1,7 +1,7 @@
 get:
  operationId: GetOrdersOrderReservations
-  summary: Get reservations for an Order
-  description: Retrieves reservations for an Order
+  summary: Get reservations of an Order
+  description: Retrieves reservations of an Order
  x-authenticated: true
  parameters:
    - in: path
@@ -23,10 +23,6 @@ get:
        type: integer
        default: 20
  x-codeSamples:
-    - lang: JavaScript
-      label: JS Client
-      source:
-        $ref: ../code_samples/JavaScript/admin_orders_{id}_reservations/get.js
    - lang: Shell
      label: cURL
      source:
--- a/docs/api/admin/paths/admin_product-categories_{id}.yaml
+++ b/docs/api/admin/paths/admin_product-categories_{id}.yaml
@@ -126,7 +126,7 @@ post:
 delete:
  operationId: DeleteProductCategoriesCategory
  summary: Delete a Product Category
-  description: Deletes a ProductCategory.
+  description: Deletes a Product Category.
  x-authenticated: true
  parameters:
    - in: path
--- a/docs/api/admin/paths/admin_product-categories_{id}_products_batch.yaml
+++ b/docs/api/admin/paths/admin_product-categories_{id}_products_batch.yaml
@@ -1,6 +1,6 @@
 post:
  operationId: PostProductCategoriesCategoryProductsBatch
-  summary: Add Products to a category
+  summary: Add Products to a Category
  description: Assign a batch of products to a product category.
  x-authenticated: true
  parameters:
@@ -66,7 +66,7 @@ post:
      $ref: ../components/responses/500_error.yaml
 delete:
  operationId: DeleteProductCategoriesCategoryProductsBatch
-  summary: Delete Products
+  summary: Remove Products from Category
  description: Remove a list of products from a product category.
  x-authenticated: true
  parameters:
--- a/docs/api/admin/paths/admin_reservations.yaml
+++ b/docs/api/admin/paths/admin_reservations.yaml
@@ -81,6 +81,10 @@ get:
    method: list
    queryParams: AdminGetReservationsParams
  x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/admin_reservations/get.js
    - lang: Shell
      label: cURL
      source:
@@ -111,8 +115,8 @@ get:
      $ref: ../components/responses/500_error.yaml
 post:
  operationId: PostReservations
-  summary: Creates a Reservation
-  description: Creates a Reservation which can be associated with any resource as required.
+  summary: Create a Reservation
+  description: Create a Reservation which can be associated with any resource as required.
  x-authenticated: true
  requestBody:
    content:
--- a/docs/api/admin/paths/admin_reservations_{id}.yaml
+++ b/docs/api/admin/paths/admin_reservations_{id}.yaml
@@ -1,7 +1,7 @@
 get:
  operationId: GetReservationsReservation
  summary: Get a Reservation
-  description: Retrieves a single reservation using its id
+  description: Retrieves a single reservation using its ID
  x-authenticated: true
  parameters:
    - in: path
@@ -45,7 +45,7 @@ get:
      $ref: ../components/responses/500_error.yaml
 post:
  operationId: PostReservationsReservation
-  summary: Updates a Reservation
+  summary: Update a Reservation
  description: Updates a Reservation which can be associated with any resource as required.
  x-authenticated: true
  parameters:
--- a/docs/api/admin/paths/admin_sales-channels_{id}_stock-locations.yaml
+++ b/docs/api/admin/paths/admin_sales-channels_{id}_stock-locations.yaml
@@ -1,7 +1,7 @@
 post:
  operationId: PostSalesChannelsSalesChannelStockLocation
-  summary: Associate a stock location to a Sales Channel
-  description: Associates a stock location to a Sales Channel.
+  summary: Associate a Stock Location
+  description: Associates a stock location with a Sales Channel.
  x-authenticated: true
  parameters:
    - in: path
@@ -55,7 +55,7 @@ post:
      $ref: ../components/responses/500_error.yaml
 delete:
  operationId: DeleteSalesChannelsSalesChannelStockLocation
-  summary: Remove a stock location from a Sales Channel
+  summary: Remove a Stock Location Association
  description: Removes a stock location from a Sales Channel.
  x-authenticated: true
  parameters: