add missing header docs for new API