Medusa Admin integration for AI agents.
Medusa Admin integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Medusa Admin tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.
Real Medusa Admin actions, managed and audited.
Your user connects Medusa Admin once; your agent can then manage Medusa commerce stores through the v2 Admin API — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.
- 1
Your user grants Medusa Admin access once (OAuth) — the token lands in the vault.
- 2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 3
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Supported Medusa Admin tools.
384 tools are generated from the published Medusa Admin catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.
Showing 384 tools. All published catalog entries are included in this page's server-rendered HTML.
- Delete a Campaign
- Delete a campaign by its ID. This doesn't delete promotions that belong to this campaign.
- Campaigns
- Remove a Claim Item from a Claim
- Remove an order item from a claim by the ID of the item's `WRITE_OFF_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Remove an Inbound Item from Claim
- Remove an inbound (or return) item from a claim using the `ID` of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Remove Inbound Shipping Method from Claim
- Remove the shipping method for returning items in the claim using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Remove an Outbound Item from Claim
- Remove an outbound (or new) item from a claim using the `ID` of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Remove Outbound Shipping Method from Claim
- Remove the shipping method for delivering outbound items in the claim using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Cancel Claim Request
- Cancel a requested claim.
- Claims
- Delete a Collection
- Delete a product collection.
- Collections
- Delete a Customer Group
- Delete a customer group. Customers in the group aren't deleted.
- Customer Groups
- Delete a Customer
- Delete a customer.
- Customers
- Remove an Address from Customer
- Remove a customer's address.
- Customers
- Delete a Draft Order
- Delete a draft order.
- Draft Orders
- Cancel Edit on Draft Order
- Cancel an unconfirmed edit on a draft order.
- Draft Orders
- Remove Item from Draft Order Edit
- Remove an order item from a draft order edit by the ID of the item's `ITEM_ADD` or `ITEM_UPDATE` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Draft Orders
- Remove Promotions from Draft Order Edit
- Remove specified promotions from a draft order edit.
- Draft Orders
- Remove New Shipping Method from Draft Order
- Remove a shipping method that was added to a draft order edit using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Draft Orders
- Remove Shipping Method from Draft Order Edit
- Remove an existing shipping method from a draft order edit.
- Draft Orders
- Remove Inbound Item from Exchange
- Remove an inbound (or return) item from an exchange using the `ID` of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Remove Inbound Shipping Method from Exchange
- Remove the shipping method for returning items in the exchange using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Remove Outbound Item from Exchange
- Remove an outbound (or new) item from an exchange using the `ID` of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Remove Outbound Shipping Method from Exchange
- Remove the shipping method for delivering outbound items in the exchange using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Cancel Exchange Request
- Cancel a requested exchange.
- Exchanges
- Delete Fulfillment Set
- Delete a fulfillment set.
- Fulfillment Sets
- Remove a Service Zone from Fulfillment Set
- Remove a service zone that belongs to a fulfillment set.
- Fulfillment Sets
- Delete Inventory Item
- Delete an inventory item.
- Inventory Items
- Remove Inventory Level of Inventory Item
- Remove the inventory level of an inventory item. If the inventory level has reserved quantity greater than `0`, an error is thrown.
- Inventory Items
- Delete Invite
- Delete an invite.
- Invites
- Clear Configuration of Layout
- Clears all user layout configurations for a given zone. This action will remove any customizations made by the user and revert to the system defaults.
- Layouts
- Cancel Order Edit
- Cancel a requested order edit.
- Order Edits
- Remove Item from Order Edit
- Remove an added item in the order edit by the ID of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Order Edits
- Remove Shipping Method from Order Edit
- Remove a shipping method in the order edit by the ID of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Order Edits
- Delete a Payment Collection
- Delete a payment collection.
- Payment Collections
- Delete a Price List
- Delete a price list.
- Price Lists
- Delete a Price Preference
- Delete a price preference.
- Price Preferences
- Delete a Product Category
- Delete a product category. This doesn't delete the products in that category. A product category that has child categories can't be deleted, so you must delete its child categories first.
- Product Categories
- Delete a Product Option
- Delete a product option.
- Product Options
- Remove Value from Product Option
- Remove a Value from a product option.
- Product Options
- Delete a Product Tag
- Delete a product tag. This doesn't delete products using the tag.
- Product Tags
- Delete a Product Type
- Delete a product type. This doesn't delete products of this type.
- Product Types
- Delete a Product
- Delete a product.
- Products
- Delete Product Variant
- Delete a variant of a product.
- Products
- Remove Inventory Item Association with Product Variant
- Remove the association between an inventory item and its product variant.
- Products
- Delete a Promotion
- Delete a promotion.
- Promotions
- Delete a Property Label
- Delete a property label.
- Property Labels
- Delete a Refund Reason
- Delete a refund reason.
- Refund Reasons
- Delete a Region
- Delete a region.
- Regions
- Delete a Reservation
- Delete a reservation.
- Reservations
- Delete a Return Reason
- Delete a return reason.
- Return Reasons
- Remove Damaged Item from Return
- Remove a damaged item, whose quantity is to be dismissed, in the return by the ID of the item's `RECEIVE_DAMAGED_RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Cancel Return Receival
- Cancel the receival process previously started, and hasn't been confirmed, of a return.
- Returns
- Remove a Received Item from Return
- Remove a received item in the return by the ID of the item's `RECEIVE_RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Cancel Return Request
- Cancel a requested return.
- Returns
- Remove Item from Return
- Remove a requested item to be returned by the ID of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Remove Shipping Method from Return
- Remove a shipping method of the return by the ID of the item's `SHIPPING_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Returns
- Delete a Sales Channel
- Delete a sales channel.
- Sales Channels
- Delete a Shipping Option Type
- Delete a shipping option type.
- Shipping Option Types
- Delete a Shipping Option
- Delete a shipping option.
- Shipping Options
- Delete a Shipping Profile
- Delete a shipping profile.
- Shipping Profiles
- Delete a Stock Location
- Delete a stock location.
- Stock Locations
- Delete a Tax Rate
- Delete a tax rate.
- Tax Rates
- Remove Rule of Tax Rate
- Remove a tax rate's rule.
- Tax Rates
- Delete a Tax Region
- Delete a tax region.
- Tax Regions
- Delete a File
- Delete a file. Uses the installed file module provider to delete the file.
- Uploads
- Delete a User
- Delete a user.
- Users
- Remove View Configurations
- Remove view configurations of an entity. An admin user can only delete their own configurations.
- Views
- List Campaigns
- Retrieve a list of campaigns. The campaigns can be filtered by fields such as `id`. The campaigns can also be sorted or paginated.
- Campaigns
- Get a Campaign
- Retrieve a campaign by its ID. You can expand the campaign's relations or select the fields that should be returned using the query parameters.
- Campaigns
- List Claims
- Retrieve a list of claims. The claims can be filtered by fields such as `id`. The claims can also be sorted or paginated.
- Claims
- Get a Claim
- Retrieve a claim by its ID. You can expand the claim's relations or select the fields that should be returned using the query parameters.
- Claims
- List Collections
- Retrieve a list of collections. The collections can be filtered by fields such as `id`. The collections can also be sorted or paginated.
- Collections
- Get a Collection
- Retrieve a collection by its ID. You can expand the collection's relations or select the fields that should be returned using the query parameters.
- Collections
- List Currencies
- Retrieve a list of currencies. The currencies can be filtered by fields such as `id`. The currencies can also be sorted or paginated.
- Currencies
- Get a Currency
- Retrieve a currency by its code. You can expand the currency's relations or select the fields that should be returned using the query parameters.
- Currencies
- List Customer Groups
- Retrieve a list of customer groups. The customer groups can be filtered by fields such as `id`. The customer groups can also be sorted or paginated.
- Customer Groups
- Get a Customer Group
- Retrieve a customer group by its ID. You can expand the customer group's relations or select the fields that should be returned.
- Customer Groups
- List Customers
- Retrieve a list of customers. The customers can be filtered by fields such as `id`. The customers can also be sorted or paginated.
- Customers
- Get a Customer
- Retrieve a customer by its ID. You can expand the customer's relations or select the fields that should be returned.
- Customers
- List Addresses
- Retrieve a list of addresses in a customer. The addresses can be filtered by fields like `query`. The addresses can also be paginated.
- Customers
- List Addresses
- Retrieve a list of a customer's addresses. The addresses can be filtered by fields like `company`. The addresses can also be paginated.
- Customers
- List Draft Orders
- Retrieve a list of draft orders. The draft orders can be filtered by fields such as `id`. The draft orders can also be sorted or paginated.
- Draft Orders
- Get a Draft Order
- Retrieve a draft order by its ID. You can expand the draft order's relations or select the fields that should be returned using the query parameters.
- Draft Orders
- List Exchanges
- Retrieve a list of exchanges. The exchanges can be filtered by fields such as `id`. The exchanges can also be sorted or paginated.
- Exchanges
- Get an Exchange
- Retrieve an exchange by its ID. You can expand the exchange's relations or select the fields that should be returned using query parameters.
- Exchanges
- List Feature Flags
- Retrieve a list of feature flags. The feature flags can be filtered by fields such as `id`. The feature flags can also be sorted or paginated.
- Feature Flags
- List Fulfillment Providers
- Retrieve a list of fulfillment providers. The fulfillment providers can be filtered by fields such as `id`. The fulfillment providers can also be sorted or paginated.
- Fulfillment Providers
- List Fulfillment Options
- Retrieve the list of fulfillment options of a fulfillment provider. These options may be retrieved from an integrated third-party service.
- Fulfillment Providers
- Get a Service Zone in a Fulfillment Set
- Retrieve a service zone that belongs to a fulfillment set. be paginated.
- Fulfillment Sets
- List Gift Cards
- Retrieve a list of gift cards. The gift cards can be filtered by fields such as `id`. The gift cards can also be sorted or paginated.
- Gift Cards
- Get a Gift Card
- Retrieve a gift card by its ID. You can expand the gift card's relations or select the fields that should be returned.
- Gift Cards
- List Gift Card's Orders
- Retrieve the list of orders that a gift card was used in.
- Gift Cards
- Get Index Details
- Retrieve index metadata, including entity type, status, last synced key, and last updated timestamp.
- Index
- List Inventory Items
- Retrieve a list of inventory items. The inventory items can be filtered by fields such as `id`. The inventory items can also be sorted or paginated.
- Inventory Items
- Get a Inventory Item
- Retrieve a inventory item by its ID. You can expand the inventory item's relations or select the fields that should be returned.
- Inventory Items
- List Inventory Levels
- Retrieve a list of inventory levels associated with an inventory item. The inventory levels can be filtered by fields like `location_id`. The inventory levels can also be paginated.
- Inventory Items
- List Invites
- Retrieve a list of invites. The invites can be filtered by fields such as `id`. The invites can also be sorted or paginated.
- Invites
- Get an Invite
- Retrieve an invite by its ID. You can expand the invite's relations or select the fields that should be returned.
- Invites
- List Layout Configurations
- Retrieve a list of layout configurations made by admin users. The layouts can be filtered by fields such as `id`. The layouts can also be sorted or paginated.
- Layouts
- List Layout Configurations
- Retrieve a list of layout configurations for a specific zone. These are the configurations made by the users for their admin dashboard layouts.
- Layouts
- List Locales
- Retrieve a list of locales. The locales can be filtered by fields such as `code`. The locales can also be sorted or paginated.
- Locales
- Get a Locale
- Retrieve a locale by its code. You can expand the locale's relations or select the fields that should be returned.
- Locales
- List Notifications
- Retrieve a list of notifications. The notifications can be filtered by fields such as `id`. The notifications can also be sorted or paginated.
- Notifications
- Get a Notification
- Retrieve a notification by its ID. You can expand the notification's relations or select the fields that should be returned.
- Notifications
- List Orders
- Retrieve a list of orders. The orders can be filtered by fields such as `id`. The orders can also be sorted or paginated.
- Orders
- Get an Order
- Retrieve an order by its ID. You can expand the order's relations or select the fields that should be returned.
- Orders
- List Changes on an Order
- Retrieve a list of changes made on an order, including returns, exchanges, etc... The changes can be filtered by fields like `created_at`. The changes can also be paginated.
- Orders
- List Line Items
- Retrieve a list of line items in a order. The line items can be filtered by fields like FILTER FIELDS. The line items can also be paginated.
- Orders
- Get Preview
- Retrieve a preview of an order using its associated change, such as an edit.
- Orders
- List Shipping Options for Order
- Retrieve a list of shipping options that can be used for outbound shipping in an order. This is especially useful when adding outbound shipping to order exchanges or claims.
- Orders
- List Payments
- Retrieve a list of payments. The payments can be filtered by fields such as `id`. The payments can also be sorted or paginated.
- Payments
- Get a Payment
- Retrieve a payment by its ID. You can expand the payment's relations or select the fields that should be returned.
- Payments
- List Payment Providers
- Retrieve a list of payment providers. The payment providers can be filtered by fields such as `id`. The payment providers can also be sorted or paginated.
- Payments
- List Plugins
- Retrieve the list of plugins installed in the Medusa application.
- Plugins
- List Price Lists
- Retrieve a list of price lists. The price lists can be filtered by fields such as `id`. The price lists can also be sorted or paginated.
- Price Lists
- Get a Price List
- Retrieve a price list by its ID. You can expand the price list's relations or select the fields that should be returned.
- Price Lists
- List Prices for a Price List
- Retrieve a list of prices in a price list. The prices can be filtered by fields like FILTER FIELDS. The prices can also be paginated.
- Price Lists
- List Price Preferences
- Retrieve a list of price preferences. The price preferences can be filtered by fields such as `id`. The price preferences can also be sorted or paginated.
- Price Preferences
- Get a Price Preference
- Retrieve a price preference by its ID. You can expand the price preference's relations or select the fields that should be returned.
- Price Preferences
- List Product Categories
- Retrieve a list of product categories. The product categories can be filtered by fields such as `id`. The product categories can also be sorted or paginated.
- Product Categories
- Get a Product Category
- Retrieve a product category by its ID. You can expand the product category's relations or select the fields that should be returned.
- Product Categories
- List Product Options
- Retrieve a list of product options. The product options can be filtered by fields such as `id`. The product options can also be sorted or paginated.
- Product Options
- Get a Product Option
- Retrieve a product option by its ID. You can expand the product option's relations or select the fields that should be returned.
- Product Options
- List Product Option Values
- Retrieve a list of values in a product option. The values can be filtered by fields like `id`. The values can also be paginated.
- Product Options
- Get Product Option Value
- Get a product option value by its ID.
- Product Options
- List Product Tags
- Retrieve a list of product tags. The product tags can be filtered by fields such as `id`. The product tags can also be sorted or paginated.
- Product Tags
- Get a Product Tag
- Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned.
- Product Tags
- List Product Types
- Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated.
- Product Types
- Get a Product Type
- Retrieve a product type by its ID. You can expand the product type's relations or select the fields that should be returned.
- Product Types
- List Product Variants
- Retrieve a list of product variants. The product variants can be filtered by fields such as `id`. The product variants can also be sorted or paginated.
- Product Variants
- List Products
- Retrieve a list of products. The products can be filtered by fields such as `id`. The products can also be sorted or paginated.
- Products
- Get a Product
- Retrieve a product by its ID. You can expand the product's relations or select the fields that should be returned.
- Products
- List a Product's Options
- Retrieve a list of options of a product. The options can be filtered by fields like `id`. The options can also be paginated.
- Products
- List Variants of a Product
- Retrieve a list of variants in a product. The variants can be filtered by fields like FILTER FIELDS. The variants can also be paginated.
- Products
- Get Variant of a Product
- Retrieve a product's variant by its ID.
- Products
- List Promotions
- Retrieve a list of promotions. The promotions can be filtered by fields such as `id`. The promotions can also be sorted or paginated.
- Promotions
- Get a Promotion
- Retrieve a promotion by its ID. You can expand the promotion's relations or select the fields that should be returned.
- Promotions
- List Rules of a Promotion
- Retrieve a list of rules in a promotion. The type of rules retrieved depend on the value of the `rule_type` path parameter: - If `rule_type` is `rules`, the promotion's rules are retrivied. - If `rule_type` is `target-rules`, the target rules of the promotion's application method are retrieved. - If `rule_type` is `buy-rules`, the buy rules of the promotion's application method are retrieved.
- Promotions
- List Rule Attribute Options of a Rule Type
- Retrieve a list of potential rule attributes for the promotion and application method types specified in the query parameters. Only the attributes of the rule type specified in the path parameter are retrieved: - If `rule_type` is `rules`, the attributes of the promotion's type are retrieved. - If `rule_type` is `target-rules`, the target rules' attributes of the application method's type are retrieved. - If `rule_type` is `buy-rules`, the buy rules' attributes of the application method's type are retrieved.
- Promotions
- List Rule Values Given a Rule Attribute
- Retrieve all potential values for promotion rules and target and buy rules based on the specified rule attribute and type. For example, if you provide the ID of the `currency_code` rule attribute, and set `rule_type` to `rules`, a list of currencies are retrieved in label-value pairs.
- Promotions
- List Property Labels
- Retrieve a list of property labels. The property labels can be filtered by fields such as `id`. The property labels can also be sorted or paginated.
- Property Labels
- Get a Property Label
- Retrieve a property label by its ID.
- Property Labels
- List Refund Reasons
- Retrieve a list of refund reasons. The refund reasons can be filtered by fields such as `id`. The refund reasons can also be sorted or paginated.
- Refund Reasons
- Get a Refund Reason
- Retrieve a refund reason by its ID. You can expand the refund reason's relations or select the fields that should be returned.
- Refund Reasons
- List Regions
- Retrieve a list of regions. The regions can be filtered by fields such as `id`. The regions can also be sorted or paginated.
- Regions
- Get a Region
- Retrieve a region by its ID. You can expand the region's relations or select the fields that should be returned.
- Regions
- List Reservations
- Retrieve a list of reservations. The reservations can be filtered by fields such as `id`. The reservations can also be sorted or paginated.
- Reservations
- Get a Reservation
- Retrieve a reservation by its ID. You can expand the reservation's relations or select the fields that should be returned.
- Reservations
- List Return Reasons
- Retrieve a list of return reasons. The return reasons can be filtered by fields such as `id`. The return reasons can also be sorted or paginated.
- Return Reasons
- Get a Return Reason
- Retrieve a return reason by its ID. You can expand the return reason's relations or select the fields that should be returned.
- Return Reasons
- List Returns
- Retrieve a list of returns. The returns can be filtered by fields such as `id`. The returns can also be sorted or paginated.
- Returns
- Get a Return
- Retrieve a return by its ID. You can expand the return's relations or select the fields that should be returned.
- Returns
- List Sales Channels
- Retrieve a list of sales channels. The sales channels can be filtered by fields such as `id`. The sales channels can also be sorted or paginated.
- Sales Channels
- Get a Sales Channel
- Retrieve a sales channel by its ID. You can expand the sales channel's relations or select the fields that should be returned.
- Sales Channels
- List Search
- Retrieve a list of search. The search can be filtered by fields such as `id`. The search can also be sorted or paginated.
- Search
- List Shipping Option Types
- Retrieve a list of shipping option types. The shipping option types can be filtered by fields such as `id`. The shipping option types can also be sorted or paginated.
- Shipping Option Types
- Get a Shipping Option Type
- Retrieve a shipping option type by its ID. You can expand the shipping option type's relations or select the fields that should be returned.
- Shipping Option Types
- List Shipping Options
- Retrieve a list of shipping options. The shipping options can be filtered by fields such as `id`. The shipping options can also be sorted or paginated.
- Shipping Options
- Get a Shipping Option
- Retrieve a shipping option by its ID. You can expand the shipping option's relations or select the fields that should be returned.
- Shipping Options
- List Shipping Profiles
- Retrieve a list of shipping profiles. The shipping profiles can be filtered by fields such as `id`. The shipping profiles can also be sorted or paginated.
- Shipping Profiles
- Get a Shipping Profile
- Retrieve a shipping profile by its ID. You can expand the shipping profile's relations or select the fields that should be returned.
- Shipping Profiles
- List Stock Locations
- Retrieve a list of stock locations. The stock locations can be filtered by fields such as `id`. The stock locations can also be sorted or paginated.
- Stock Locations
- Get a Stock Location
- Retrieve a stock location by its ID. You can expand the stock location's relations or select the fields that should be returned.
- Stock Locations
- List Store Credit Accounts
- Retrieve a list of store credit accounts. The store credit accounts can be filtered by fields such as `id`. The store credit accounts can also be sorted or paginated.
- Store Credit Accounts
- Get a Store Credit Account
- Retrieve a store credit account by its ID. You can expand the store credit account's relations or select the fields that should be returned.
- Store Credit Accounts
- List Transactions
- Retrieve a list of transactions in a store credit account. The transactions can be filtered by fields like FILTER FIELDS. The transactions can also be paginated.
- Store Credit Accounts
- List Stores
- Retrieve a list of stores. The stores can be filtered by fields such as `id`. The stores can also be sorted or paginated.
- Stores
- Get a Store
- Retrieve a store by its ID. You can expand the store's relations or select the fields that should be returned.
- Stores
- List Tax Providers
- Retrieve a list of tax providers installed in the Medusa application through Tax Module Providers. The tax providers can be filtered by fields such as `id`. The tax providers can also be sorted or paginated.
- Tax Providers
- List Tax Rates
- Retrieve a list of tax rates. The tax rates can be filtered by fields such as `id`. The tax rates can also be sorted or paginated.
- Tax Rates
- Get a Tax Rate
- Retrieve a tax rate by its ID. You can expand the tax rate's relations or select the fields that should be returned.
- Tax Rates
- List Tax Regions
- Retrieve a list of tax regions. The tax regions can be filtered by fields such as `id`. The tax regions can also be sorted or paginated.
- Tax Regions
- Get a Tax Region
- Retrieve a tax region by its ID. You can expand the tax region's relations or select the fields that should be returned.
- Tax Regions
- List Translations
- Retrieve a list of translations. The translations can be filtered by fields such as `reference_id` (For example, the ID of a product). The translations can also be sorted or paginated.
- Translations
- List Translatable Entities
- Retrieve a list of translatable entities. The entities can be filtered by fields such as `id`. The entities can also be sorted or paginated.
- Translations
- List Translation Settings
- Retrieve the list of translatable fields for all entities, such as products and collections. You can also filter the results by entity type or active entities.
- Translations
- Retrieve Translation Statistics
- Get statistics on translations for specified locales and entity types. This includes overall translation progress for each entity type, and statistics for each locale within those entity types.
- Translations
- Get a File
- Retrieve an uploaded file by its ID. You can expand the file's relations or select the fields that should be returned.
- Uploads
- List Users
- Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated.
- Users
- Get a User
- Retrieve a user by its ID. You can expand the user's relations or select the fields that should be returned.
- Users
- Get Logged-In User
- Retrieve the logged-in user's details.
- Users
- List Views
- Retrieve a list of views. The views can be filtered by fields such as `id`. The views can also be sorted or paginated.
- Views
- List Columns in View
- Retrieve a list of columns in a view for an entity. The columns are retrieved for the authenticated admin user.
- Views
- List View Configurations
- Retrieve a list of view configurations of an entity. The configurations can be filtered by fields like `id`. The configurations can also be paginated. An admin user can only retrieve their own configurations.
- Views
- Get Active View Configuration
- Get the active view configurations for an entity. If no active view is set, `null` is returned. An admin user can only retrieve their own active configuration.
- Views
- Get View Configuration
- Retrieve a view configuration for an entity. An admin user can only retrieve their own configurations.
- Views
- List Workflows Executions
- Retrieve a list of workflows executions. The workflows executions can be filtered by fields such as `id`. The workflows executions can also be sorted or paginated.
- Workflows Executions
- Get a Workflows Execution
- Retrieve a workflows execution by its ID. You can expand the workflows execution's relations or select the fields that should be returned.
- Workflows Executions
- Subscribe to a Workflow's Execution
- Subscribe to a workflow's execution to receive real-time information about its steps, status, and data. This route returns an event stream that you can consume using the [EventSource API](https://developer.mozilla.org/en-US/docs/Web/API/EventSource).
- Workflows Executions
- Get Workflow Execution's Details
- Get the details of the workflow's execution.
- Workflows Executions
- Subscribe to Workflow Execution Events
- Subscribe to workflow execution events for a specific workflow and transaction. This endpoint establishes a Server-Sent Events (SSE) connection, allowing clients to receive real-time updates about the workflow execution. The events include details such as the event type, workflow ID, transaction ID, step information, response, result, and any errors that occur during the execution.
- Workflows Executions
- Create Campaign
- Create a campaign.
- Campaigns
- Update a Campaign
- Update a campaign's details.
- Campaigns
- Manage the Promotions of a Campaign
- Manage the promotions of a campaign, either by adding them or removing them from the campaign.
- Campaigns
- Create a Claim
- Create a claim. The claim is still in the request state, and the changes are only applied on the order once the claim is confirmed.
- Claims
- Cancel a Claim
- Cancel a claim and its associated return.
- Claims
- Add Claim Items to a Claim
- Add order items to a claim as claim items. These claim items will have the action `WRITE_OFF_ITEM`.
- Claims
- Update a Claim Item
- Update an order item in a claim by the ID of the item's `WRITE_OFF_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Add Inbound Items to a Claim
- Add inbound (or return) items to a claim. These inbound items will have a `RETURN_ITEM` action.
- Claims
- Update Inbound Items of a Claim
- Update an inbound (or return) item of a claim using the `ID` of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Add an Inbound Shipping Method to a Claim
- Add an inbound (or return) shipping method to a claim. The inbound shipping method will have a `SHIPPING_ADD` action.
- Claims
- Update Inbound Shipping Method of a Claim
- Update the shipping method for returning items in the claim using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Add Outbound Items to a Claim
- Add outbound (or new) items to a claim. These outbound items will have an `ITEM_ADD` action.
- Claims
- Update Outbound Item of a Claim
- Update an outbound (or new) item of a claim using the `ID` of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Add Outbound Shipping Methods to a Claim
- Add an outbound shipping method to a claim. The outbound shipping method will have a `SHIPPING_ADD` action.
- Claims
- Update Outbound Shipping Method of a Claim
- Update the shipping method for delivering outbound items in a claim using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Claims
- Confirm a Claim Request
- Confirm a claim request, applying its changes on the associated order.
- Claims
- Create Collection
- Create a collection.
- Collections
- Update a Collection
- Update a collection's details.
- Collections
- Manage Products of a Collection
- Manage the products of a collection by adding or removing them from the collection.
- Collections
- Create Customer Group
- Create a customer group.
- Customer Groups
- Update a Customer Group
- Update a customer group's details.
- Customer Groups
- Manage Customers of a Customer Group
- Manage the customers of a group to add or remove them from the group.
- Customer Groups
- Create Customer
- Create a customer.
- Customers
- Update a Customer
- Update a customer's details.
- Customers
- Add a Customer Address
- Add an address to a customer.
- Customers
- Update a Customer's Address
- Update a customer address's details.
- Customers
- Manage Customer Groups of Customer
- Manage the customer groups of a customer, adding or removing the customer from those groups.
- Customers
- Create Draft Order
- Create a draft order. This creates an order with the `is_draft_order` property enabled. You can later convert the draft order to an order.
- Draft Orders
- Update a Draft Order
- Update a draft order's details. This doesn't include updating the draft order's items, shipping methods, or promotions. To update those, you need to create an edit that you can later request or confirm.
- Draft Orders
- Convert a Draft Order to an Order
- Convert a draft order to an order. This will finalize the draft order and create a new order with the same details.
- Draft Orders
- Create a Draft Order Edit
- Create an edit on a draft order. This will allow you to make changes to the draft order's items, shipping methods, or promotions. Once you've made the necessar changes, you can later either request the edit (which requires a confirmation from the customer), or force-confirm the edit.
- Draft Orders
- Confirm an Edit on a Draft Order
- Confirm an edit on a draft order. This will apply the changes made to the draft order.
- Draft Orders
- Add Item to Draft Order Edit
- Add an item to a draft order edit.
- Draft Orders
- Update New Item in Draft Order Edit
- Update a new item that was added to a draft order edit by the ID of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Draft Orders
- Update Existing Item in Draft Order Edit
- Update an existing item in a draft order edit.
- Draft Orders
- Add Promotions to Draft Order Edit
- Add promotions to a draft order edit.
- Draft Orders
- Request Edit on Draft Order
- Change the status of a draft order's edit to be requested. Later, the edit can be confirmed or canceled.
- Draft Orders
- Add Shipping Method to Draft Order Edit
- Add a shipping method to a draft order edit.
- Draft Orders
- Update New Shipping Method in Draft Order Edit
- Update a new shipping method that was added to a draft order edit using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Draft Orders
- Update Existing Shipping Method in Draft Order Edit
- Update an existing shipping method in a draft order edit.
- Draft Orders
- Create Exchange
- Create an exchange request. Its changes aren't applied on the order until the exchange is confirmed.
- Exchanges
- Cancel an Exchange
- Cancel an exchange and its associated return.
- Exchanges
- Add Inbound Items to an Exchange
- Add inbound (or return) items to an exchange. These inbound items will have the action `RETURN_ITEM`.
- Exchanges
- Update an Inbount Item of an Exchange
- Update an inbound (or return) item from an exchange using the `ID` of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Add an Inbound Shipping Method to an Exchange
- Add an inbound (or return) shipping method to an exchange. The inbound shipping method will have a `SHIPPING_ADD` action.
- Exchanges
- Update Inbound Shipping Method of an Exchange
- Update the shipping method for returning items in the exchange using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Add Outbound Items to Exchange
- Add outbound (or new) items to an exchange. These outbound items will have the action `ITEM_ADD`.
- Exchanges
- Update Outbound Item of an Exchange
- Update an outbound (or new) item from an exchange using the `ID` of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Add Outbound Shipping Method to Exchange
- Add an outbound shipping method to an exchange. The outbound shipping method will have a `SHIPPING_ADD` action.
- Exchanges
- Update Outbound Shipping Method of Exchange
- Update the shipping method for delivering outbound items in the exchange using the `ID` of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Exchanges
- Confirm an Exchange
- Confirm an exchange request, applying its changes on the associated order.
- Exchanges
- Add a Service Zone to a Fulfillment Set
- Add a service zone to a fulfillment set.
- Fulfillment Sets
- Update the Service Zone of a Fulfillment Set
- Update the details of a service zone in a fulfillment set.
- Fulfillment Sets
- Create Fulfillment
- Create a fulfillment for an order, return, exchange, and more.
- Fulfillments
- Cancel a Fulfillment
- Cancel a fulfillment. The fulfillment can't be shipped or delivered. To cancel the fulfillment, the `cancelFulfillment` method of the associated fulfillment provider is used.
- Fulfillments
- Create a Shipment for a Fulfillment
- Create a shipment for a fulfillment. The fulfillment must not be shipped or canceled.
- Fulfillments
- Create Gift Card
- Create a gift card.
- Gift Cards
- Update a Gift Card
- Update a gift card's details.
- Gift Cards
- Trigger Index Sync
- Trigger reindexing or re-ingestion of the Index Module.
- Index
- Create Inventory Item
- Create an inventory item.
- Inventory Items
- Export Inventory Items
- Start an inventory items export process to retrieve a CSV of exported inventory items. You'll receive in the response the transaction ID of the workflow generating the CSV file. To check the status of the execution, send a GET request to `/admin/workflows-executions/export-inventory-items/:transaction-id`. Once the execution finishes successfully, a notification is created for the export. You can retrieve the notifications using the `/admin/notification` API route to retrieve the file's download URL.
- Inventory Items
- Update an Inventory Item
- Update an inventory item's details.
- Inventory Items
- Create Inventory Level for Inventory Item
- Create an inventory level for an inventory item.
- Inventory Items
- Manage Inventory Levels of Inventory Item
- Manage the inventory levels of an inventory item to create or delete them.
- Inventory Items
- Update an Inventory Level of an Inventory Item
- Updates the details of an inventory item's inventory level using its associated location ID.
- Inventory Items
- Manage Inventory Levels
- Manage inventory levels to create, update, or delete them.
- Inventory Items
- Create Invite
- Create a invite.
- Invites
- Accept Invite
- Accept an invite and create a new user. Since the user isn't created yet, the JWT token used in the authorization header is retrieved from the `/auth/user/emailpass/register` API route (or a provider other than `emailpass`). The user can then authenticate using the `/auth/user/emailpass` API route.
- Invites
- Refresh Invite Token
- Refresh the token of an invite.
- Invites
- Add Layout Configuration
- Add a layout configuration for a specific zone. This allows you to customize the layout of the admin dashboard for that zone, including the arrangement of widgets and other UI elements.
- Layouts
- Update an Order Change
- Update an order change's details. An order change can be an exchange, claim, or edit. For example, you can edit whether an exchange carries over the parent order's promotion.
- Order Changes
- Create Order Edit
- Create an order edit.
- Order Edits
- Confirm Order Edit
- Confirm an order edit request and apply the changes on the order.
- Order Edits
- Add Items to Order Edit
- Add new items to an order edit. These items will have the action `ITEM_ADD`.
- Order Edits
- Update an Item in an Order Edit
- Update an added item in the order edit by the ID of the item's `ITEM_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Order Edits
- Update Order Item Quantity of Order Edit
- Update an existing order item's quantity of an order edit. You can also use this API route to remove an item from an order by setting its quantity to `0`.
- Order Edits
- Request Order Edit
- Change the status of an active order edit to requested.
- Order Edits
- Add Shipping Method to Order Edit
- Add a shipping method to an exchange. The shipping method will have a `SHIPPING_ADD` action.
- Order Edits
- Update Shipping Method of an Order Edit
- Update a shipping method in the order edit by the ID of the method's `SHIPPING_ADD` action. Every shipping method has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Order Edits
- Export Orders
- Start an order export process to retrieve a CSV of exported orders. You'll receive in the response the transaction ID of the workflow generating the CSV file. To check the status of the execution, send a GET request to `/admin/workflows-executions/export-orders/:transaction-id`. Once the execution finishes successfully, a notification is created for the export. You can retrieve the notifications using the `/admin/notification` API route to retrieve the file's download URL.
- Orders
- Update Order
- Update an order's details. Updating the order's shipping or billing address doesn't recalculate the order's taxes or totals; the existing tax lines are preserved as-is. You also can't change the address's `country_code`.
- Orders
- Archive an Order
- Change the status of an order to archived.
- Orders
- Cancel Order
- Cancel an order. The cancelation fails if: - The order has captured payments. - The order has refund payments. - The order has fulfillments that aren't canceled.
- Orders
- Complete Order
- Mark an order as completed.
- Orders
- Create Credit Line for Order
- Create a credit line for an order.
- Orders
- Create an Order Fulfillment
- Create a fulfillment for an order. The creation fails if the order is canceled.
- Orders
- Cancel Fulfillment
- Cancel an order's fulfillment. The fulfillment can't be canceled if it's shipped.
- Orders
- Mark a Fulfillment as Delivered.
- Mark an order's fulfillment as delivered.
- Orders
- Create Shipment for an Order's Fulfillment
- Create a shipment for an order's fulfillment.
- Orders
- Authorize Payment Session
- Authorize a payment session for an order. This is useful for orders created from draft orders.
- Orders
- Request Order Transfer
- Request an order to be transfered to another customer. The transfer is confirmed by sending a request to the [Accept Order Transfer](https://docs.medusajs.com/api/store#orders_postordersidtransferaccept) Store API route.
- Orders
- Cancel Transfer Request
- Cancel a request to transfer an order to another customer.
- Orders
- Transfer Order to Guest Customer
- Transfer an order to a guest customer. This is useful when the order email was incorrectly entered and you want to set it to a guest customer. The order will be transferred to a new guest customer with the provided email. For transferring orders to registered customer, check out the [Request Order Transfer](https://docs.medusajs.com/api/admin#orders_postordersidtransfer) API route instead.
- Orders
- Create Payment Collection
- Create a payment collection.
- Payment Collections
- Mark a Payment Collection as Paid
- Mark a payment collection as paid. This creates and authorizes a payment session, then capture its payment, using the manual payment provider.
- Payment Collections
- Initialize Payment Session in Payment Collection
- Initialize a Payment Session in a payment collection. This is useful for orders placed outside the checkout flow, such as draft orders, or when a payment session needs to be re-initialized for an existing payment collection.
- Payment Collections
- Capture Payment
- Capture an amount of a payment. This uses the `capturePayment` method of the payment provider associated with the payment's collection.
- Payments
- Refund Payment
- Refund an amount of a payment. This uses the `refundPayment` method of the payment provider associated with the payment's collection.
- Payments
- Create Price List
- Create a price list.
- Price Lists
- Update a Price List
- Update a price list's details.
- Price Lists
- Manage Prices in Price List
- Manage the prices of a price list to create, update, or delete them.
- Price Lists
- Remove Products from Price List
- Remove products from a price list.
- Price Lists
- Create Price Preference
- Create a price preference.
- Price Preferences
- Update a Price Preference
- Update a price preference's details.
- Price Preferences
- Create Product Category
- Create a product category.
- Product Categories
- Update a Product Category
- Update a product category's details.
- Product Categories
- Manage Products in Product Category
- Manage products of a category to add or remove them.
- Product Categories
- Create Product Option
- Create a product option.
- Product Options
- Update a Product Option
- Update a product option's details.
- Product Options
- Update Product Option Value
- Update a product option value's details.
- Product Options
- Create Product Tag
- Create a product tag.
- Product Tags
- Update a Product Tag
- Update a product tag's details.
- Product Tags
- Create Product Type
- Create a product type.
- Product Types
- Update a Product Type
- Update a product type's details.
- Product Types
- Create Product
- Create a product.
- Products
- Manage Products
- Manage products to create, update, or delete them.
- Products
- Export Products
- Start a product export process to retrieve a CSV of exported products. You'll receive in the response the transaction ID of the workflow generating the CSV file. To check the status of the execution, send a GET request to `/admin/workflows-executions/export-products/:transaction-id`. Once the execution finishes successfully, a notification is created for the export. You can retrieve the notifications using the `/admin/notification` API route to retrieve the file's download URL.
- Products
- Update a Product
- Update a product's details.
- Products
- Manage Variants of Product Image
- Manage the association between product variants and a product image. You can add or remove associations between variants and the image.
- Products
- Add Options to Product
- Add a list of options to a product.
- Products
- Create a Product Variant
- Create a variant for a product.
- Products
- Manage Variants in a Product
- Manage variants in a product to create, update, or delete them.
- Products
- Manage Variants Inventory in a Product
- Manage a product's variant's inventoris to associate them with inventory items, update their inventory items, or delete their association with inventory items.
- Products
- Update a Product Variant
- Update a variant's details.
- Products
- Manage Images of Product Variant
- Manage the association between product images and a product variant. You can add or remove associations between images and the variant.
- Products
- Associate Variant with Inventory Item
- Associate with a product variant an inventory item that manages its inventory details.
- Products
- Update Product Variant's Inventory Details
- Update the inventory item that manages the inventory details of a product variant.
- Products
- Create Product Import
- Create a new product import process. The products aren't imported until the import is confirmed with the `/admin/products/:transaction-id/import` API route.
- Products
- Confirm Product Import
- Confirm that a created product import should start importing the products into Medusa.
- Products
- Create Product Import
- Create a new product import process. The products aren't imported until the import is confirmed with the `/admin/products/:transaction-id/imports` API route.
- Products
- Confirm Product Import
- Confirm that a created product import should start importing the products into Medusa.
- Products
- Create Promotion
- Create a promotion.
- Promotions
- Update a Promotion
- Update a promotion's details.
- Promotions
- Manage the Buy Rules of a Promotion
- Manage the buy rules of a `buyget` promotion to create, update, or delete them.
- Promotions
- Manage a Promotion's Rules
- Manage the rules of a promotion to create, update, or delete them.
- Promotions
- Manage Target Rules of a Promotion
- Manage the target rules of a promotion to create, update, or delete them.
- Promotions
- Create Property Label
- Create a property label.
- Property Labels
- Create Property Label
- Create a property label.
- Property Labels
- Update a Property Label
- Update a property label's details.
- Property Labels
- Create Refund Reason
- Create a refund reason.
- Refund Reasons
- Update a Refund Reason
- Update a refund reason's details.
- Refund Reasons
- Create Region
- Create a region.
- Regions
- Update a Region
- Update a region's details.
- Regions
- Create Reservation
- Create a reservation.
- Reservations
- Update a Reservation
- Update a reservation's details.
- Reservations
- Create Return Reason
- Create a return reason.
- Return Reasons
- Update a Return Reason
- Update a return reason's details.
- Return Reasons
- Create Return
- Create a return. The return can later be requested or confirmed.
- Returns
- Update a Return
- Update a return's details.
- Returns
- Cancel a return.
- Cancel a return.
- Returns
- Add Damaged Items to Return
- Add damaged items, whose quantity is to be dismissed, to a return. These items will have the action `RECEIVE_DAMAGED_RETURN_ITEM`.
- Returns
- Update Damaged Item of Return
- Update a damaged item, whose quantity is to be dismissed, in the return by the ID of the item's `RECEIVE_DAMAGED_RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Start Return Receival
- Start a return receival process to be later confirmed using the `/admin/returns/:id/receive/confirm` API route.
- Returns
- Confirm Return Receival
- Confirm that a return has been received. This updates the quantity of the items received, if not damaged, and reflects the changes on the order.
- Returns
- Add Received Items to Return
- Add received items in a return. These items will have the action `RECEIVE_RETURN_ITEM`.
- Returns
- Update a Received Item in a Return
- Update a received item in the return by the ID of the item's `RECEIVE_RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Confirm Return Request
- Confirm a requested return. The changes are applied on the inventory quantity and the order only after the return has been confirmed as received using the `/admin/returns/:id/received/confirm`.
- Returns
- Add Requested Items to Return
- Add items that are requested to be returned. These items will have the action `RETURN_ITEM`.
- Returns
- Update Requested Item in Return
- Update a requested item to be returned by the ID of the item's `RETURN_ITEM` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property. return.
- Returns
- Add a Shipping Method to a Return
- Add a shipping method to a return. The shipping method will have a `SHIPPING_ADD` action.
- Returns
- Update a Shipping Method of a Return
- Update a shipping method of the return by the ID of the item's `SHIPPING_ADD` action. Every item has an `actions` property, whose value is an array of actions. You can check the action's name using its `action` property, and use the value of the `id` property.
- Returns
- Create Sales Channel
- Create a sales channel.
- Sales Channels
- Update a Sales Channel
- Update a sales channel's details.
- Sales Channels
- Manage Products in Sales Channel
- Manage products in a sales channel to add or remove them from the channel.
- Sales Channels
- Create Shipping Option Type
- Create a shipping option type.
- Shipping Option Types
- Update a Shipping Option Type
- Update a shipping option type's details.
- Shipping Option Types
- Create Shipping Option
- Create a shipping option.
- Shipping Options
- Update a Shipping Option
- Update a shipping option's details. When you provide the `prices` array, it replaces the shipping option's existing flat-rate prices: - A price with a matching `id` is updated. - A price without an `id` is created - Any existing price whose `id` isn't included in the array is deleted. The `rules` you provide for a price similarly replace that price's existing rules, so omit a rule to remove it. Omitting the `prices` property entirely leaves the existing prices unchanged, whereas setting `price_type` to `calculated` removes all flat-rate prices.
- Shipping Options
- Manage the Rules of a Shipping Option
- Manage the rules of a shipping option to create, update, or delete them.
- Shipping Options
- Create Shipping Profile
- Create a shipping profile.
- Shipping Profiles
- Update a Shipping Profile
- Update a shipping profile's details.
- Shipping Profiles
- Create Stock Location
- Create a stock location.
- Stock Locations
- Update a Stock Location
- Update a stock location's details.
- Stock Locations
- Manage Fulfillment Providers of a Stock Location
- Manage the fulfillment providers to add or remove them from a stock location.
- Stock Locations
- Add Fulfillment Set to Stock Location
- Create and add a fulfillment set to a stock location.
- Stock Locations
- Manage Sales Channels of a Stock Location
- Manage the sales channels in a stock location by adding or removing them.
- Stock Locations
- Create Store Credit Account
- Create a store credit account.
- Store Credit Accounts
- Add Credit to Store Credit Account
- Add credit to a store credit account
- Store Credit Accounts
- Update a Store
- Update a store's details.
- Stores
- Create Tax Rate
- Create a tax rate.
- Tax Rates
- Update a Tax Rate
- Update a tax rate's details.
- Tax Rates
- Create Tax Rule for a Rate
- Create a tax rule for a rate.
- Tax Rates
- Create Tax Region
- Create a tax region.
- Tax Regions
- Update a Tax Region
- Update a tax region's details.
- Tax Regions
- Manage Translations
- Manage translations in bulk by creating, updating, or deleting multiple translations in a single request. You can manage translations for various resources such as products, product variants, categories, and more.
- Translations
- Manage Translation Settings
- Create, update, or delete multiple translation settings.
- Translations
- Upload Files
- Upload files to the configured File Module Provider.
- Uploads
- Get Presigned Upload URL
- Get a presigned URL for uploading a file to the configured File Module Provider. The presigned URL can be used to upload files directly to the third-party provider. This only works if your configured provider supports presigned URLs, such as the S3 provider.
- Uploads
- Update a User
- Update a user's details.
- Users
- Create View Configuration
- Create a new view configuration for an entity. If `is_system_default` is set to true, the created configuration will be set as the system default for the specified entity. Otherwise, it will be a custom configuration for the admin user.
- Views
- Make View Configuration Active
- Make a view configuration active. This will set the given view configuration as the active one for the specified entity for the admin user. An admin user can only set their own configurations as active. If the view configuration ID is `null`, the active view configuration will be cleared, and the `code` or system default view configuration type will be used as the active view.
- Views
- Update View Configuration
- Update the view configuration of an entity. An admin user can only update their own configurations.
- Views
- Execute a Workflow
- Execute a workflow by its ID.
- Workflows Executions
- Fail a Step in a Workflow's Execution
- Set the status of a step in a workflow's execution as failed. This is useful for long-running workflows.
- Workflows Executions
- Succeed a Step in a Workflow's Execution
- Set the status of a step in a workflow's execution as successful. This is useful for long-running workflows.
- Workflows Executions
Medusa Admin integration, answered
- How do AI agents use Medusa Admin through Open Connector?
- Your user connects Medusa Admin once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Medusa Admin tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
- Is this a Medusa Admin MCP server?
- Yes. Open Connector can serve Medusa Admin as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Medusa Admin actions with credentials injected server-side.
- Where do Medusa Admin credentials live?
- In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.
Give your agents Medusa Admin — keep the keys.
Open source, self-hostable, with Medusa Admin credentials that never leave your infrastructure. Run it from source today.