Routing

API routes

Modules expose SDK-native API endpoints by implementing HasApiRoutes.

• A module returns ApiRouteDefinition[] from getApiRoutes().
• Each route path is local to the module.
• The runtime mounts those routes under /api/modules/{slug}/....

This keeps route declarations portable across runtimes and avoids hard-coding full WordPress REST paths inside modules.

UI routes

Modules expose admin pages by implementing HasUiRoutes.

• A module returns UiRouteDefinition[] from getUiRoutes().
• The runtime maps those definitions into admin-side entrypoints.

Legacy bridge

The runtime still carries a compatibility bridge for legacy modules that rely on HasRestRoutes / raw WordPress REST patterns.

Treat that bridge as transitional. New module work should target HasApiRoutes and HasUiRoutes first.

Param rules and middleware

ApiRouteDefinition can declare:

• request methods
• middleware
• capability requirements
• parameter rules

The WordPress router adapts those definitions into WP REST registrations. Keep route paths local to the module and let the runtime add the canonical prefix.