adjust api description to show defaults