last preliminaries before API rewrite