Spec changes for OpenAPI generator

Created by: creckord

These commits contain various changes to make the spec work better with the OpenAPI generator.

They're mostly adding naming and some cleanup and should not cause any noticable changes to the REST API.