Some cleanups prior to generating/fixing the contents:

• Prettier
• Rename param names to match our internal routes (so they won't be seen as a different route soon)
• Reorder fields in a more natural / human-readable / consistent fashion
• Move all "path params" into a central definition that's shared between all endpoints
• Make all route path start with /v2
• Can we move all "tags" to the path, not endpoint level? Nope, this is not valid syntax.
• Make all route params work with $ref, too