Align the openapi spec to the actual API wherever possible