api changes for instances