How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Medusa Products API

A product is a set of variants that the customer chooses from when making a purchase.A product can be organized into categories or collections.A product can have many options, and variants for each of these options' values.These API routes allow admin users to manage products.

Medusa Products API is one of 82 APIs that Medusa publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Product. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 27 operations across 20 paths, and defines 75 schemas. It is described by OpenAPI 3.2.0, at version 2.19.0.

Requests are made against 2 base URLs: http://localhost:9000, https://api.medusajs.com.

27 operations 20 paths 75 schemas 3 DELETE7 GET17 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.19.0
Base URL
https://{medusa-backend-domain}
Authentication
HTTP Basic, HTTP Bearer, API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 4

Medusa Products API declares 4 security schemes for authenticating requests. It accepts HTTP basic authentication (api_token). It accepts HTTP bearer tokens (jwt_token). An API key is passed in the cookie as connect.sid (cookie_auth). It accepts HTTP bearer tokens (reset_password).

Paths & Operations 27

Across 20 paths, the API surfaces 27 operations — 3 DELETE, 7 GET, 17 POST. Each is listed below with its method, path, parameters, and response codes.

Products 27

A product is a set of variants that the customer chooses from when making a purchase. A product can be organized into categories or collections. A product can have many options, a…

GET
/admin/products
List Products
GetProducts 26 params → 200400401404409422500
POST
/admin/products
Create Product
PostProducts 1 param body → 200400401404409422500
POST
/admin/products/batch
Manage Products
PostProductsBatch 1 param body → 200400401404409422500
POST
/admin/products/export
Export Products
PostProductsExport 27 params → 202400401404409422500
POST
/admin/products/importdeprecated
Create Product Import
PostProductsImport body → 202400401404409422500
POST
/admin/products/import/{transaction_id}/confirmdeprecated
Confirm Product Import
PostProductsImportTransaction_idConfirm 1 param → 202400401404409422500
POST
/admin/products/imports
Create Product Import
PostProductsImports body → 202400401404409422500
POST
/admin/products/imports/{transaction_id}/confirm
Confirm Product Import
PostProductsImportsTransaction_idConfirm 1 param → 202400401404409422500
GET
/admin/products/{id}
Get a Product
GetProductsId 2 params → 200400401404409422500
POST
/admin/products/{id}
Update a Product
PostProductsId 2 params body → 200400401404409422500
DELETE
/admin/products/{id}
Delete a Product
DeleteProductsId 1 param → 200400401404409422500
POST
/admin/products/{id}/images/{image_id}/variants/batch
Manage Variants of Product Image
PostProductsIdImagesImage_idVariantsBatch 2 params body → 200400401404409422500
GET
/admin/products/{id}/options
List a Product's Options
GetProductsIdOptions 12 params → 200400401404409422500
POST
/admin/products/{id}/options/batch
Add Options to Product
PostProductsIdOptionsBatch 1 param body → 200400401404409422500
GET
/admin/products/{id}/variants
List Variants of a Product
GetProductsIdVariants 19 params → 200400401404409422500
POST
/admin/products/{id}/variants
Create a Product Variant
PostProductsIdVariants 2 params body → 200400401404409422500
POST
/admin/products/{id}/variants/batch
Manage Variants in a Product
PostProductsIdVariantsBatch 2 params body → 200400401404409422500
POST
/admin/products/{id}/variants/inventory-items/batch
Manage Variants Inventory in a Product
PostProductsIdVariantsInventoryItemsBatch 1 param body → 200400401404409422500
GET
/admin/products/{id}/variants/{variant_id}
Get Variant of a Product
GetProductsIdVariantsVariant_id 3 params → 200400401404409422500
POST
/admin/products/{id}/variants/{variant_id}
Update a Product Variant
PostProductsIdVariantsVariant_id 3 params body → 200400401404409422500
DELETE
/admin/products/{id}/variants/{variant_id}
Delete Product Variant
DeleteProductsIdVariantsVariant_id 3 params → 200400401404409422500
POST
/admin/products/{id}/variants/{variant_id}/images/batch
Manage Images of Product Variant
PostProductsIdVariantsVariant_idImagesBatch 2 params body → 200400401404409422500
POST
/admin/products/{id}/variants/{variant_id}/inventory-items
Associate Variant with Inventory Item
PostProductsIdVariantsVariant_idInventoryItems 3 params body → 200400401404409422500
POST
/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}
Update Product Variant's Inventory Details
PostProductsIdVariantsVariant_idInventoryItemsInventory_item_id 4 params body → 200400401404409422500
DELETE
/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}
Remove Inventory Item Association with Product Variant
DeleteProductsIdVariantsVariant_idInventoryItemsInventory_item_id 4 params → 200400401404409422500
GET
/store/products
List Products
GetProducts 29 params → 200400401404409422500
GET
/store/products/{id}
Get a Product
GetProductsId 9 params → 200400401404409422500

Schemas 75

The contract defines 75 schemas that model the data the API accepts and returns. The most detailed are AdminProduct (34 properties), AdminProductVariant (31 properties), BaseProduct (31 properties), StoreProduct (31 properties). Each schema is shown below with its type and property counts.

AdminProductOptionValue
object
The product option value's details.
9 properties 2 required
BaseCollection
object
The product collection's details.
9 properties 7 required
AdminProductVariantInventoryItemLink
object
An association between a product variant and an inventory item.
6 properties 3 required
AdminUpdateProductVariant
object
The properties to update of a product variant.
19 properties
AdminProductVariant
object
The product variant's details.
31 properties 22 required
BaseProductOption
object
The product option's details.
9 properties 3 required
AdminProductOption
object
The product option's details.
9 properties 3 required
Error
object
3 properties
AdminProductVariantInventoryLink
object
A created association between a product variant and an inventory item.
2 properties 2 required
BaseProductOptionValue
object
The product option value's details.
9 properties 2 required
BaseCalculatedPriceSet
object
The calculated price's details.
14 properties 6 required
AdminProductVariantResponse
object
The product variant's details.
1 property 1 required
AdminBatchVariantInventoryItems
object
The product variant inventories to manage.
3 properties
AdminProductResponse
object
The product's details.
1 property 1 required
AdminBatchProductVariantResponse
object
The details of the product variants created, updated, or deleted.
3 properties 3 required
AdminProduct
object
The product's details.
34 properties 27 required
AdminCreateProductVariant
object
The product variant's details.
20 properties 2 required
AdminUpdateProductVariantPrice
object
The details of a variant's price.
6 properties
AdminBatchUpdateProductVariant
object
The properties to update of a product variant.
21 properties 1 required
AdminCreateProductVariantPrice
object
The details of a variant's price.
5 properties 2 required
AdminBatchProductResponse
object
The details of the products created, updated, or deleted.
3 properties 3 required
AdminProductCategory
object
The product category's details.
15 properties 13 required
AdminProductDeleteResponse
object
The details of the product deletion.
3 properties 3 required
BaseProductType
object
The product type's details.
7 properties 4 required
BaseProductCategory
object
The product category's details.
15 properties 13 required
AdminLinkProductOptionWithValues
object
The details for linking a product option with its values.
2 properties 2 required
AdminImportProducts
object
The details of the product's import file.
5 properties 5 required
AdminCreateProductOption
object
The product option's details.
4 properties 2 required
AdminProductVariantInventoryBatchResponse
object
The created, updated, and deleted associations between variants and inventory items.
3 properties 3 required
AdminBatchUpdateVariantInventoryItem
object
Update a product variant's association with an inventory item.
3 properties 3 required
AdminPrice
object
The price's details.
11 properties 11 required
AdminBatchImageVariantRequest
object
Details of the associations between variants and a product image to manage.
2 properties
AdminLinkProductOptions
object
The details of linking product options to a product.
3 properties
AdminSalesChannel
object
The sales channel's details.
8 properties 8 required
AdminProductImage
object
The image's details.
9 properties 3 required
AdminUpdateProductOption
object
The details to update in a product option.
6 properties
BaseProduct
object
The product's details.
31 properties 26 required
AdminCreateProduct
object
The product's details.
27 properties 1 required
AdminCollection
object
The product collection's details.
10 properties 7 required
AdminShippingProfile
object
The shipping profile's details..
7 properties 7 required
AdminBatchCreateVariantInventoryItem
object
The associations to create between a product variant and an inventory item.
3 properties 3 required
AdminUpdateVariantInventoryItem
object
The properties to update of the variant's inventory item association.
1 property 1 required
AdminImportProductRequest
object
The import's details.
1 property 1 required
AdminInventoryItem
object
The inventory item's details.
18 properties 4 required
AdminBatchVariantImagesResponse
object
Result of managing the associations between images and a product variant.
2 properties 2 required
BaseProductImage
object
The image's details.
7 properties 3 required
AdminInventoryLevel
object
The location level's location levels.
12 properties 11 required
AdminCreateVariantInventoryItem
object
The details of the variant-inventory item association.
2 properties 2 required
AdminBatchVariantImagesRequest
object
Details of the associations between images and a product variant to manage.
2 properties
AdminBatchProductRequest
object
The products to create, update, or delete.
3 properties
AdminProductType
object
The product type's details.
8 properties 4 required
AdminUpdateProduct
object
The product's details.
26 properties
AdminExportProductResponse
object
The details of the product export.
1 property 1 required
AdminImportProductResponse
object
The import process's details.
2 properties 2 required
AdminBatchProductVariantRequest
object
The product variants to create, update, or delete.
3 properties
AdminBatchDeleteVariantInventoryItem
object
Delete a product variant's association with an inventory item.
2 properties 2 required
AdminProductTag
object
The product tag's details.
8 properties 4 required
AdminCreateProductVariantInventoryKit
object
The details of a variant's inventory item.
2 properties 2 required
AdminUpdateProductOptionValues
object
The details to update a product option's values.
3 properties 1 required
AdminProductVariantInventoryLinkDeleteResponse
object
The details of the deleted associated between a product variant and an inventory item.
4 properties 4 required
AdminBatchUpdateProduct
object
The product's details.
28 properties 1 required
AdminBatchImageVariantResponse
object
Result of managing the associations between variants and a product image.
2 properties 2 required
BaseProductTag
object
The product tag's details.
7 properties 4 required
AdminProductVariantDeleteResponse
object
The details of the product variant's deletion.
4 properties 3 required
AdminTranslation
object
The translation's details.
8 properties 8 required
StoreProductTag
object
The tag's details.
7 properties 4 required
StoreProductType
object
The product type's details.
7 properties 4 required
StoreProductListResponse
object
The paginated list of products.
StoreProductOptionValue
object
The product option value's details.
9 properties 2 required
StoreProductVariant
object
The variant's details.
28 properties 21 required
StoreProduct
object
The product's details.
31 properties 26 required
StoreProductOption
object
The product option's details.
10 properties 3 required
StoreProductImage
object
The image's details.
7 properties 3 required
StoreCollection
object
The collection's details.
9 properties 7 required
StoreProductResponse
object
The product's details.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

medusa-products-api-openapi.yml Raw ↑

Other APIs Medusa publishes across the network.

Medusa GraphQL API
Medusa MCP Remote Server
Medusa Api Keys API
Medusa Auth API
Medusa [auth Provider] API
Medusa Campaigns API
Medusa Carts API
Medusa Claims API
Medusa Collections API
Medusa Currencies API
Medusa Customer Groups API
Medusa Customers API
Where this information came from

This is an independent, third-party profile of Medusa Products API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.