FileSystemService.promoteTransient Method
        
 Promotes the transient file to a real one.
 
         
        Parameters
        
            - id
            
 
            - 
                
Type: String
The ID of the file to promote. 
            - newName
            
 
            - 
                
Type: String
The new name for the promoted file. 
            - parentId
            
 
            - 
                
Type: String
The ID of the new parent for the real file. 
            - overwrite
            
 
            - 
                
Type: Boolean
(optional) If a file with the same name already exists, setting this flag will overwrite the existing file.
Optional: True 
        
        Return Value
        
Type: jQuery.Promise
        
Value: String
        
A promise object that is resolved when the call is complete.