document PUT case in API