Update: OpenAPI Specification Improvements

Hey everyone,

we went ahead with the first batch of changes, adding operationIds and changing the securityScheme.

The change log as all the details.