tentative completion of api for section 1