docs: clarify route middleware scope

onmax · onmax · commit 2fcf1efe3114 · 2025-11-03T09:12:05.000+01:00
diff --git a/docs/1.getting-started/07.routing.md b/docs/1.getting-started/07.routing.md
@@ -90,6 +90,10 @@ Nuxt provides a customizable route middleware framework you can use throughout y
 Route middleware runs within the Vue part of your Nuxt app. Despite the similar name, they are completely different from server middleware, which are run in the Nitro server part of your app.
 ::
 
+::important
+Route middleware does **not** run for API routes (`/api/*`) or other server requests. To handle server requests, use [server middleware](/docs/4.x/guide/directory-structure/server#server-middleware) instead.
+::
+
 There are three kinds of route middleware:
 
 1. Anonymous (or inline) route middleware, which are defined directly in the pages where they are used.
