add jsdoc for new swagger methods