outlining api when instance is passed