Second part of T2745
add paths/endpoints & related, so this thing:
which includes:
https://swagger.io/specification/#paths-object
https://swagger.io/specification/#parameter-object
https://swagger.io/specification/#request-body-object
https://swagger.io/specification/#responses-object