[CO-303] Re-generate swagger.json API files

[KtorZ]

Applied feedbacks from Jane Wild on the documentation. Minor typos fixing, unfortunately, not very visible in the diff :/