chore/fix: minor improvements in types, docs and required properties

[vercel[bot]]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/five-binaries/openapi/4D4vxR1uN1fEHw5vkRfij1cAkmB8
✅ Preview: https://openapi-git-1000101-improvements-five-binaries.vercel.app