no-service-mutations-in-api-route - ESLint plugin rules

This rule disallows calling service mutation methods directly from an API route handler.

Severity#

warn. This rule is enabled in the recommended preset.

What it Targets#

This rule targets route.ts and route.js files in your project's src/api directory. It reports calls to mutation methods, such as create, update, or delete methods, on a service resolved from the container.

The following code is reported by the rule:

src/api/admin/products/route.ts
1export const POST = async (req, res) => {2  const productModule = req.scope.resolve(Modules.PRODUCT)3  await productModule.createProducts(req.body)4  res.status(200).json({})5}

Instead, move the mutation into a workflow and run it:

src/api/admin/products/route.ts
1export const POST = async (req, res) => {2  await createProductWorkflow(req.scope).run({3    input: req.body,4  })5  res.status(200).json({})6}

Why it's Important#

Workflows provide rollback, error handling, and a single place to maintain business logic. Calling service mutations directly in a route bypasses these benefits and makes the logic harder to reuse.

Learn more in the Workflows documentation.

Fixable#

This rule isn't auto-fixable.

Turn it Off#

To turn off this rule, set it to off in your ESLint configuration:

eslint.config.ts
1import { defineConfig } from "eslint/config"2import medusa from "@medusajs/eslint-plugin"3
4export default defineConfig([5  ...medusa.configs.recommended,6  {7    rules: {8      "@medusajs/no-service-mutations-in-api-route": "off",9    },10  },11])

Or disable it for a single line using an inline comment:

Code
1// eslint-disable-next-line @medusajs/no-service-mutations-in-api-route2await productModule.createProducts(req.body)