small updates to input parameters, added example response