improved upload api documentation