> ## Documentation Index > Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt > Use this file to discover all available pages before exploring further. # Admin API > Operator routes under /admin/* for sellers, commissions, payouts, master catalog, and marketplace-wide orders. The Admin API is the marketplace operator's surface. It extends Medusa's standard admin routes with the marketplace domains below. Everything else, such as regions, currencies, users, or API keys, comes from Medusa core unchanged. Authentication and shared conventions are covered in [API conventions](/rc/references/api/conventions). ## Sellers | Method | Path | Purpose | | --------------- | ----------------------------------------- | ------------------------------------ | | `GET` `POST` | `/admin/sellers` | List sellers / create a seller | | `GET` `POST` | `/admin/sellers/:id` | Retrieve / update a seller | | `POST` | `/admin/sellers/:id/approve` | Approve a pending seller | | `POST` | `/admin/sellers/:id/suspend` | Suspend a seller | | `POST` | `/admin/sellers/:id/unsuspend` | Lift a suspension | | `POST` | `/admin/sellers/:id/terminate` | Terminate a seller | | `POST` | `/admin/sellers/:id/unterminate` | Reverse a termination | | `POST` | `/admin/sellers/:id/address` | Upsert the seller address | | `POST` | `/admin/sellers/:id/payment-details` | Upsert payment details | | `POST` `DELETE` | `/admin/sellers/:id/professional-details` | Upsert / remove professional details | | `GET` | `/admin/sellers/:id/products` | List the seller's products | ### Members and invites | Method | Path | Purpose | | ------------ | ------------------------------------------------------ | ------------------------------- | | `GET` | `/admin/members` | List members across all sellers | | `GET` `POST` | `/admin/sellers/:id/members` | List / add a member | | `DELETE` | `/admin/sellers/:id/members/:member_id` | Remove a member | | `POST` | `/admin/sellers/:id/members/invite` | Invite a member | | `GET` | `/admin/sellers/:id/members/invites` | List pending invites | | `DELETE` | `/admin/sellers/:id/members/invites/:invite_id` | Revoke an invite | | `POST` | `/admin/sellers/:id/members/invites/:invite_id/resend` | Resend an invite | ## Commission rates | Method | Path | Purpose | | --------------------- | ----------------------------------- | ------------------------------------------------------------- | | `GET` `POST` | `/admin/commission-rates` | List rates (supports the `scope_type` filter) / create a rate | | `GET` `POST` `DELETE` | `/admin/commission-rates/:id` | Retrieve / update / delete a rate | | `POST` | `/admin/commission-rates/:id/rules` | Batch add and remove rules on a rate | ## Payouts | Method | Path | Purpose | | ------ | -------------------- | ----------------------------------- | | `GET` | `/admin/payouts` | List payouts across the marketplace | | `GET` | `/admin/payouts/:id` | Retrieve a payout | ## Products (master catalog) Products are shared catalog records. See [master products](/platform/catalog/concepts/master-products). | Method | Path | Purpose | | --------------------- | ------------------------------------------ | --------------------------------------------------------------- | | `GET` `POST` | `/admin/products` | List / create a product (`seller_ids` sets selling eligibility) | | `GET` `POST` `DELETE` | `/admin/products/:id` | Retrieve / update / delete a product | | `GET` | `/admin/products/:id/preview` | Preview the product with pending changes applied | | `POST` | `/admin/products/:id/confirm` | Confirm the pending change | | `POST` | `/admin/products/:id/reject` | Reject the pending change | | `POST` | `/admin/products/:id/request-changes` | Send a change back to the seller for action | | `POST` | `/admin/products/:id/sellers` | Set the selling-eligibility allowlist | | `POST` | `/admin/products/:id/attributes/batch` | Batch add / update / remove product attributes | | `GET` `POST` | `/admin/products/:id/variants` | List / create variants | | `GET` `POST` `DELETE` | `/admin/products/:id/variants/:variant_id` | Retrieve / update / delete a variant | ### Product changes | Method | Path | Purpose | | ------ | ------------------------------------ | --------------------------------- | | `POST` | `/admin/product-changes/:id/confirm` | Confirm a change request directly | | `POST` | `/admin/product-changes/:id/cancel` | Cancel a change request | ## Offers | Method | Path | Purpose | | -------------- | --------------------- | ---------------------------------------- | | `GET` | `/admin/offers` | List offers (supports `group_by_seller`) | | `GET` `DELETE` | `/admin/offers/:id` | Retrieve / delete an offer | | `POST` | `/admin/offers/batch` | Batch create offers | ## Product attributes | Method | Path | Purpose | | --------------------- | ------------------------------------------------ | --------------------------------------- | | `GET` `POST` | `/admin/product-attributes` | List / create attributes | | `GET` `POST` `DELETE` | `/admin/product-attributes/:id` | Retrieve / update / delete an attribute | | `POST` | `/admin/product-attributes/:id/values` | Create a value | | `POST` `DELETE` | `/admin/product-attributes/:id/values/:value_id` | Update / delete a value | ## Categories and collections | Method | Path | Purpose | | --------------------- | ---------------------------------------- | --------------------------------------------- | | `GET` `POST` | `/admin/product-categories` | List / create categories (with media + icon) | | `GET` `POST` `DELETE` | `/admin/product-categories/:id` | Retrieve / update / delete a category | | `POST` | `/admin/product-categories/:id/products` | Batch link products | | `POST` | `/admin/product-categories/:id/sellers` | Batch link sellers | | `GET` `POST` | `/admin/collections` | List / create collections (with media + icon) | | `GET` `POST` `DELETE` | `/admin/collections/:id` | Retrieve / update / delete a collection | ## Orders and order groups | Method | Path | Purpose | | ------ | ------------------------------------ | --------------------------------------------- | | `GET` | `/admin/orders` | List all orders across sellers | | `GET` | `/admin/orders/:id/commission-lines` | Commission lines computed for an order | | `GET` | `/admin/orders/:id/order-group` | The order group an order belongs to | | `GET` | `/admin/order-groups` | List order groups | | `GET` | `/admin/order-groups/:id` | Retrieve an order group with its child orders | ### Order edits, claims, exchanges, returns Mercur extends the Medusa RMA routes so they respect seller boundaries: | Method | Path | Purpose | | --------------- | ------------------------------------- | --------------------------------- | | `POST` | `/admin/order-edits/:id/items` | Add items to an order edit | | `POST` | `/admin/order-edits/:id/confirm` | Confirm an order edit | | `POST` | `/admin/claims/:id/outbound/items` | Add outbound items to a claim | | `POST` `DELETE` | `/admin/claims/:id/request` | Request / cancel a claim | | `POST` | `/admin/exchanges/:id/outbound/items` | Add outbound items to an exchange | | `POST` `DELETE` | `/admin/exchanges/:id/request` | Request / cancel an exchange | | `POST` | `/admin/returns/:id/receive/confirm` | Confirm receipt of a return | ## Next steps