api example updates