job files for new api calls
jsdoc improvement