Routes that redirect should specify the redirect in the openapi schema

[RickMoynihan]

For example this area is quite sparse in the swagger doc:

Ideally we should model a RedirectResponseobject in the swagger spec associated with a 302, that response object should then specify a location header of type string.