extended 'flatten' api documentation