This is why I like NestJS's swagger integration which derives your spec from class-validator payload constraints and some endpoint decorators, if/as those change it updates automatically.