mechanics for some APIs have changed