Schedule and Push Upgrades to Unlocked and Second-Generation Managed Packages (Beta)

We extended the PackagePushRequest SOAP API object to enable push upgrades to unlocked and second-generation managed packages. You can choose which orgs receive a package upgrade, what version the package is upgraded to, and when you want the upgrade to occur. Query the PackagePushJob and PackagePushError SOAP API objects to track the status of each job, see which upgrades succeeded, and review any error messages.

Where: This change applies to installed versions of unlocked and second-generation managed packages.

As a beta feature, Push Upgrades for Unlocked and Second-Generation Managed Packages is a preview and isn’t part of the “Services” under your master subscription agreement with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all, and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply equally to your use of this feature. You can provide feedback and suggestions for Push Upgrade for Unlocked and Second-Generation Managed Package in the Unlocked Packages group in the Trailblazer Community or the Managed Packages group in the Partner Community

Who: Users need the System Administrator profile or the Create and Update Second-Generation Packages permission.

Why: Owners of unlocked and second-generation managed packages can now push package upgrades without burdening subscribers with that step. This functionality is crucial if you must push a change for a hot bug fix.