roughed in definitions and api