How to remove some middleware route from scalar/swagger

[nont65]

I use nuxt4 and nitro with openapi config like this

nuxt.config.ts

export default defineNuxtConfig({
  compatibilityDate: '2025-07-15',
  devtools: { enabled: true },
  nitro: {
    experimental: {
      openAPI: true
    },
    openAPI: {
      meta: {
        title: 'Test API',
        description: 'API documentation for Test',
        version: '1.0.0'
      },
      route: '/api/_openapi.json',
      production: 'prerender',
      ui: {
        scalar: {
          route: '/api/scalar',
          theme: 'alternate'
        },
        swagger: {
          route: '/api/swagger'
        }
      }
    }
  },
})

Then I add middleware route without use defineRouteMeta but when I open scalar or swagger, it show blank route in tag App Route like this

How to hide or remove it from generated OpenAPI document?

[sueun-dev]

That blank entry is Nitro adding your route-less middleware/ handler to the spec as an empty-path ("") operation, and it's a known open bug: #3989.

I poked at it on 2.13.4 and the obvious opt-outs don't work: defineRouteMeta({ openAPI: false }) doesn't help (the generator does h.meta?.openAPI || {}, so false just becomes {} and the route is still emitted), and { openAPI: { $global: true } } only merges into globals while the empty path still shows. The for (const h of handlersMeta) loop adds every handler with no per-route skip, so there's no clean opt-out today.

What cleared it in my test: the empty path comes specifically from a handler with no route, so moving that logic out of a global middleware/ file (apply it inside the routes that need it) drops the blank entry. Otherwise you can strip paths[""] from the served spec until #3989 lands.

[mwolf-pi3g]

+1