Swagger yaml is large and hard to manage manually

[fschade]

The current swagger yaml file grows every day and its hard to work with.

The following pain points exist:

• too large (editor gets laggy)
• everything is in one file (splitting failed the last time we tried)
• failures can be overlooked because it contains a lot of duplications

the issue is just a placeholder and could grow overtime, we need to find a way how we could fix the above issues.

[micbar]

Interesting read https://chriskapp.medium.com/typeapi-an-alternative-to-openapi-e666eefe8a76