The standard way to define a REST module should be by writing a module definition file. Module definitions are similar to OpenAPI Spec (OAS) files, and share parts of their schema with OAS. Some notable differences are:

• include a module name (path prefix) [required]
• include an audience designation (see T366567) [proposed]
• do not include parameter specs, since these will be generatde (see T366834)
• do not include body schemas, since these will be generatde (see T366834)