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>
This commit is contained in:
Shahed Nasser
2023-04-10 11:15:54 +03:00
committed by GitHub
parent 5280e1bdad
commit ae017c4657
46 changed files with 221 additions and 296 deletions

View File

@@ -5791,8 +5791,8 @@
"/admin/inventory-items": {
"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": [
{
@@ -5947,12 +5947,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.list()\n.then(({ inventory_items }) => {\n console.log(inventory_items.length);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.list()\n.then(({ inventory_items, count, offset, limit }) => {\n console.log(inventory_items.length);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json'\n"
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items' \\\n--header 'Authorization: Bearer {api_token}'\n"
}
],
"security": [
@@ -5999,7 +5999,7 @@
},
"post": {
"operationId": "PostInventoryItems",
"summary": "Create an Inventory Item.",
"summary": "Create an Inventory Item",
"description": "Creates an Inventory Item.",
"x-authenticated": true,
"parameters": [
@@ -6037,12 +6037,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.create(inventoryItemId, {\n variant_id: 'variant_123',\n sku: \"sku-123\",\n})\n.then(({ inventory_item }) => {\n console.log(inventory_item.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.create({\n variant_id: 'variant_123',\n})\n.then(({ inventory_item }) => {\n console.log(inventory_item.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/inventory-items' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"variant_id\": \"variant_123\",\n \"sku\": \"sku-123\",\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/inventory-items' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"variant_id\": \"variant_123\",\n}'\n"
}
],
"security": [
@@ -6091,8 +6091,8 @@
"/admin/inventory-items/{id}": {
"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": [
{
@@ -6134,7 +6134,7 @@
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json'\n"
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}' \\\n--header 'Authorization: Bearer {api_token}'\n"
}
],
"security": [
@@ -6181,7 +6181,7 @@
},
"post": {
"operationId": "PostInventoryItemsInventoryItem",
"summary": "Update an Inventory Item.",
"summary": "Update an Inventory Item",
"description": "Updates an Inventory Item.",
"x-authenticated": true,
"parameters": [
@@ -6340,8 +6340,8 @@
"/admin/inventory-items/{id}/location-levels": {
"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": [
{
@@ -6353,24 +6353,6 @@
"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",
@@ -6401,7 +6383,7 @@
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}/location-levels' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json'\n"
"source": "curl --location --request GET 'https://medusa-url.com/admin/inventory-items/{id}/location-levels' \\\n--header 'Authorization: Bearer {api_token}'\n"
}
],
"security": [
@@ -6448,8 +6430,8 @@
},
"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": [
{
@@ -6495,12 +6477,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.createLocationLevel(inventoryItemId, {\n location_id: 'sloc',\n stocked_quantity: 10,\n})\n.then(({ inventory_item }) => {\n console.log(inventory_item.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.inventoryItems.createLocationLevel(inventoryItemId, {\n location_id: 'sloc_123',\n stocked_quantity: 10,\n})\n.then(({ inventory_item }) => {\n console.log(inventory_item.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/inventory-items/{id}/location-levels' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"location_id\": \"sloc\",\n \"stocked_quantity\": 10\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/inventory-items/{id}/location-levels' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"location_id\": \"sloc_123\",\n \"stocked_quantity\": 10\n}'\n"
}
],
"security": [
@@ -6549,8 +6531,8 @@
"/admin/inventory-items/{id}/location-levels/{location_id}": {
"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": [
{
@@ -6657,7 +6639,7 @@
},
"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": [
@@ -6692,7 +6674,7 @@
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request DELETE 'https://medusa-url.com/admin/inventory-items/{id}/location-levels/{location_id}' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json'\n"
"source": "curl --location --request DELETE 'https://medusa-url.com/admin/inventory-items/{id}/location-levels/{location_id}' \\\n--header 'Authorization: Bearer {api_token}'\n"
}
],
"security": [
@@ -10450,15 +10432,10 @@
}
},
"x-codeSamples": [
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.orders.createReservation(order_id, line_item_id, {\n location_id\n})\n.then(({ reservation }) => {\n console.log(reservation.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/orders/{id}/line-items/{line_item_id}/reservations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"location_id\": \"loc_1\"\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/orders/{id}/line-items/{line_item_id}/reserve' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"location_id\": \"loc_1\"\n}'\n"
}
],
"security": [
@@ -10608,8 +10585,8 @@
"/admin/orders/{id}/reservations": {
"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": [
{
@@ -10641,11 +10618,6 @@
}
],
"x-codeSamples": [
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.orders.retrieveReservations(order_id)\n.then(({ reservations }) => {\n console.log(reservations[0].id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
@@ -13654,7 +13626,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.retrieve(product_category_id)\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.retrieve(productCategoryId)\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
},
{
"lang": "Shell",
@@ -13753,7 +13725,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.update(product_category_id, {\n name: \"Skinny Jeans\"\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.update(productCategoryId, {\n name: \"Skinny Jeans\"\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
},
{
"lang": "Shell",
@@ -13806,7 +13778,7 @@
"delete": {
"operationId": "DeleteProductCategoriesCategory",
"summary": "Delete a Product Category",
"description": "Deletes a ProductCategory.",
"description": "Deletes a Product Category.",
"x-authenticated": true,
"parameters": [
{
@@ -13826,7 +13798,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.delete(product_category_id)\n.then(({ id, object, deleted }) => {\n console.log(id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.delete(productCategoryId)\n.then(({ id, object, deleted }) => {\n console.log(id);\n});\n"
},
{
"lang": "Shell",
@@ -13880,7 +13852,7 @@
"/admin/product-categories/{id}/products/batch": {
"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": [
@@ -13927,12 +13899,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.addProducts(product_category_id, {\n product_ids: [\n {\n id: product_id\n }\n ]\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.addProducts(productCategoryId, {\n product_ids: [\n {\n id: productId\n }\n ]\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location \\\n--request POST 'https://medusa-url.com/admin/product-categories/{product_category_id}/products/batch' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"product_ids\": [\n {\n \"id\": \"{product_id}\"\n }\n ]\n}'\n"
"source": "curl --location \\\n--request POST 'https://medusa-url.com/admin/product-categories/{id}/products/batch' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"product_ids\": [\n {\n \"id\": \"{product_id}\"\n }\n ]\n}'\n"
}
],
"security": [
@@ -13979,7 +13951,7 @@
},
"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": [
@@ -14026,7 +13998,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.removeProducts(product_category_id, {\n product_ids: [\n {\n id: product_id\n }\n ]\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.productCategories.removeProducts(productCategoryId, {\n product_ids: [\n {\n id: productId\n }\n ]\n})\n.then(({ product_category }) => {\n console.log(product_category.id);\n});\n"
},
{
"lang": "Shell",
@@ -17808,6 +17780,11 @@
"queryParams": "AdminGetReservationsParams"
},
"x-codeSamples": [
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.list()\n.then(({ reservations, count, limit, offset }) => {\n console.log(reservations.length)\n})\n"
},
{
"lang": "Shell",
"label": "cURL",
@@ -17858,8 +17835,8 @@
},
"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": {
@@ -17874,12 +17851,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.create({\n})\n.then(({ reservations }) => {\n console.log(reservations.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.create({\n line_item_id: 'item_123',\n location_id: 'loc_123',\n inventory_item_id: 'iitem_123',\n quantity: 1\n})\n.then(({ reservation }) => {\n console.log(reservation.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/reservations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"resource_id\": \"{resource_id}\",\n \"resource_type\": \"order\",\n \"value\": \"We delivered this order\"\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/reservations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"line_item_id\": \"item_123\",\n \"location_id\": \"loc_123\",\n \"inventory_item_id\": \"iitem_123\",\n \"quantity\": 1\n}'\n"
}
],
"security": [
@@ -17929,7 +17906,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": [
{
@@ -17946,7 +17923,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.retrieve(reservation_id)\n.then(({ reservation }) => {\n console.log(reservation.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.retrieve(reservationId)\n.then(({ reservation }) => {\n console.log(reservation.id);\n});\n"
},
{
"lang": "Shell",
@@ -17998,7 +17975,7 @@
},
"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": [
@@ -18025,7 +18002,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.update(reservation.id, {\n quantity: 3\n})\n.then(({ reservations }) => {\n console.log(reservations.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.update(reservationId, {\n quantity: 3\n})\n.then(({ reservation }) => {\n console.log(reservation.id);\n});\n"
},
{
"lang": "Shell",
@@ -18098,7 +18075,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.delete(reservation.id)\n.then(({ id, object, deleted }) => {\n console.log(id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.reservations.delete(reservationId)\n.then(({ id, object, deleted }) => {\n console.log(id);\n});\n"
},
{
"lang": "Shell",
@@ -19456,8 +19433,8 @@
"/admin/sales-channels/{id}/stock-locations": {
"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": [
{
@@ -19486,12 +19463,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.salesChannels.addLocation(sales_channel_id, {\n location_id: 'App'\n})\n.then(({ sales_channel }) => {\n console.log(sales_channel.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.salesChannels.addLocation(salesChannelId, {\n location_id: 'loc_123'\n})\n.then(({ sales_channel }) => {\n console.log(sales_channel.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/sales-channels/{id}/stock-locations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"locaton_id\": \"stock_location_id\"\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/sales-channels/{id}/stock-locations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"locaton_id\": \"loc_123\"\n}'\n"
}
],
"security": [
@@ -19538,7 +19515,7 @@
},
"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": [
@@ -19568,12 +19545,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.salesChannels.removeLocation(sales_channel_id, {\n location_id: 'App'\n})\n.then(({ sales_channel }) => {\n console.log(sales_channel.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.salesChannels.removeLocation(salesChannelId, {\n location_id: 'loc_id'\n})\n.then(({ sales_channel }) => {\n console.log(sales_channel.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request DELETE 'https://medusa-url.com/admin/sales-channels/{id}/stock-locations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"locaton_id\": \"stock_location_id\"\n}'\n"
"source": "curl --location --request DELETE 'https://medusa-url.com/admin/sales-channels/{id}/stock-locations' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"locaton_id\": \"loc_id\"\n}'\n"
}
],
"security": [
@@ -20628,7 +20605,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.create({\n name: 'Main Warehouse',\n location_id: 'sloc'\n})\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.create({\n name: 'Main Warehouse',\n})\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
},
{
"lang": "Shell",
@@ -20720,7 +20697,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.retrieve(stock_location_id)\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.retrieve(stockLocationId)\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
},
{
"lang": "Shell",
@@ -20800,12 +20777,12 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.update(stock_location_id, {\n name: 'App'\n})\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.update(stockLocationId, {\n name: 'Main Warehouse'\n})\n.then(({ stock_location }) => {\n console.log(stock_location.id);\n});\n"
},
{
"lang": "Shell",
"label": "cURL",
"source": "curl --location --request POST 'https://medusa-url.com/admin/stock-locations/{id}' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"name\": \"App\"\n}'\n"
"source": "curl --location --request POST 'https://medusa-url.com/admin/stock-locations/{id}' \\\n--header 'Authorization: Bearer {api_token}' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"name\": \"Main Warehouse\"\n}'\n"
}
],
"security": [
@@ -20870,7 +20847,7 @@
{
"lang": "JavaScript",
"label": "JS Client",
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.delete(stock_location_id)\n .then(({ id, object, deleted }) => {\n console.log(id)\n })\n"
"source": "import Medusa from \"@medusajs/medusa-js\"\nconst medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })\n// must be previously logged in or use api token\nmedusa.admin.stockLocations.delete(stock_location_id)\n.then(({ id, object, deleted }) => {\n console.log(id)\n})\n"
},
{
"lang": "Shell",

View File

@@ -4574,8 +4574,8 @@ paths:
/admin/inventory-items:
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
@@ -4680,15 +4680,14 @@ paths:
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);
});
- lang: Shell
label: cURL
source: |
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}'
security:
- api_token: []
- cookie_auth: []
@@ -4715,7 +4714,7 @@ paths:
$ref: '#/components/responses/500_error'
post:
operationId: PostInventoryItems
summary: Create an Inventory Item.
summary: Create an Inventory Item
description: Creates an Inventory Item.
x-authenticated: true
parameters:
@@ -4744,9 +4743,8 @@ paths:
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);
@@ -4759,7 +4757,6 @@ paths:
--header 'Content-Type: application/json' \
--data-raw '{
"variant_id": "variant_123",
"sku": "sku-123",
}'
security:
- api_token: []
@@ -4788,8 +4785,8 @@ paths:
/admin/inventory-items/{id}:
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
@@ -4826,8 +4823,7 @@ paths:
label: cURL
source: |
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}'
security:
- api_token: []
- cookie_auth: []
@@ -4854,7 +4850,7 @@ paths:
$ref: '#/components/responses/500_error'
post:
operationId: PostInventoryItemsInventoryItem
summary: Update an Inventory Item.
summary: Update an Inventory Item
description: Updates an Inventory Item.
x-authenticated: true
parameters:
@@ -4975,8 +4971,8 @@ paths:
/admin/inventory-items/{id}/location-levels:
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
@@ -4985,18 +4981,6 @@ paths:
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.
@@ -5025,8 +5009,7 @@ paths:
label: cURL
source: |
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}'
security:
- api_token: []
- cookie_auth: []
@@ -5053,8 +5036,8 @@ paths:
$ref: '#/components/responses/500_error'
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
@@ -5089,7 +5072,7 @@ paths:
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 }) => {
@@ -5102,7 +5085,7 @@ paths:
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"location_id": "sloc",
"location_id": "sloc_123",
"stocked_quantity": 10
}'
security:
@@ -5132,8 +5115,8 @@ paths:
/admin/inventory-items/{id}/location-levels/{location_id}:
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
@@ -5214,7 +5197,7 @@ paths:
$ref: '#/components/responses/500_error'
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:
@@ -5247,8 +5230,7 @@ paths:
label: cURL
source: |
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}'
security:
- api_token: []
- cookie_auth: []
@@ -8055,22 +8037,10 @@ paths:
schema:
$ref: '#/components/schemas/AdminOrdersOrderLineItemReservationReq'
x-codeSamples:
- lang: JavaScript
label: JS Client
source: |
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);
});
- lang: Shell
label: cURL
source: |
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 '{
@@ -8182,8 +8152,8 @@ paths:
/admin/orders/{id}/reservations:
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
@@ -8205,16 +8175,6 @@ paths:
type: integer
default: 20
x-codeSamples:
- lang: JavaScript
label: JS Client
source: |
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);
});
- lang: Shell
label: cURL
source: |
@@ -10491,7 +10451,7 @@ paths:
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);
});
@@ -10561,7 +10521,7 @@ paths:
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 }) => {
@@ -10603,7 +10563,7 @@ paths:
delete:
operationId: DeleteProductCategoriesCategory
summary: Delete a Product Category
description: Deletes a ProductCategory.
description: Deletes a Product Category.
x-authenticated: true
parameters:
- in: path
@@ -10621,7 +10581,7 @@ paths:
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);
});
@@ -10657,7 +10617,7 @@ paths:
/admin/product-categories/{id}/products/batch:
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:
@@ -10692,10 +10652,10 @@ paths:
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
}
]
})
@@ -10706,7 +10666,7 @@ paths:
label: cURL
source: |
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 '{
@@ -10742,7 +10702,7 @@ paths:
$ref: '#/components/responses/500_error'
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:
@@ -10777,10 +10737,10 @@ paths:
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
}
]
})
@@ -13684,6 +13644,16 @@ paths:
method: list
queryParams: AdminGetReservationsParams
x-codeSamples:
- lang: JavaScript
label: JS Client
source: |
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.list()
.then(({ reservations, count, limit, offset }) => {
console.log(reservations.length)
})
- lang: Shell
label: cURL
source: |
@@ -13715,8 +13685,8 @@ paths:
$ref: '#/components/responses/500_error'
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:
@@ -13731,9 +13701,13 @@ paths:
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);
});
- lang: Shell
label: cURL
@@ -13742,9 +13716,10 @@ paths:
--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
}'
security:
- api_token: []
@@ -13774,7 +13749,7 @@ paths:
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
@@ -13790,7 +13765,7 @@ paths:
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);
});
@@ -13825,7 +13800,7 @@ paths:
$ref: '#/components/responses/500_error'
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:
@@ -13847,11 +13822,11 @@ paths:
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);
});
- lang: Shell
label: cURL
@@ -13907,7 +13882,7 @@ paths:
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);
});
@@ -14958,8 +14933,8 @@ paths:
/admin/sales-channels/{id}/stock-locations:
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
@@ -14982,8 +14957,8 @@ paths:
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);
@@ -14995,7 +14970,7 @@ paths:
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"locaton_id": "stock_location_id"
"locaton_id": "loc_123"
}'
security:
- api_token: []
@@ -15023,7 +14998,7 @@ paths:
$ref: '#/components/responses/500_error'
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:
@@ -15047,8 +15022,8 @@ paths:
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);
@@ -15060,7 +15035,7 @@ paths:
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"locaton_id": "stock_location_id"
"locaton_id": "loc_id"
}'
security:
- api_token: []
@@ -15868,7 +15843,6 @@ paths:
// 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);
@@ -15939,7 +15913,7 @@ paths:
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);
});
@@ -15996,8 +15970,8 @@ paths:
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);
@@ -16009,7 +15983,7 @@ paths:
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "App"
"name": "Main Warehouse"
}'
security:
- api_token: []
@@ -16055,9 +16029,9 @@ paths:
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)
})
- lang: Shell
label: cURL
source: |

View File

@@ -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);
});

View File

@@ -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);

View File

@@ -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 }) => {

View File

@@ -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);
});

View File

@@ -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);
});

View File

@@ -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);
});

View File

@@ -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 }) => {

View File

@@ -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
}
]
})

View File

@@ -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
}
]
})

View File

@@ -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)
})

View File

@@ -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);
});

View File

@@ -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);
});

View File

@@ -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);
});

View File

@@ -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);
});

View File

@@ -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);

View File

@@ -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);

View File

@@ -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);

View File

@@ -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)
})

View File

@@ -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);
});

View File

@@ -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);

View File

@@ -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}'

View File

@@ -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",
}'

View File

@@ -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}'

View File

@@ -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}'

View File

@@ -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
}'

View File

@@ -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}'

View File

@@ -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 '{

View File

@@ -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 '{

View File

@@ -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
}'

View File

@@ -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"
}'

View File

@@ -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"
}'

View File

@@ -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"
}'

View File

@@ -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:

View File

@@ -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:

View File

@@ -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

View File

@@ -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:

View File

@@ -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:

View File

@@ -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:

View File

@@ -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

View File

@@ -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:

View File

@@ -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:

View File

@@ -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:

View File

@@ -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:

View File

@@ -103,7 +103,7 @@ Medusa's products configuration allows managing products of different types incl
>
- Create products with unlimited variants and options.
- Organize products into nested categories of different heirarchies.
- Organize products into nested categories of different hierarchies.
- Associate products with collections, types, and tags.
- Manage a products inventory, pricing, sales channels, and more.
- Import and export products to and from Medusa using CSV files.