SuiteApp Lifecycle Management Enhancements in NetSuite 2026.2

TL;DR: Starting in NetSuite 2026.2, enhancements to the SuiteApp Control Center REST API allow for more efficient lifecycle management of SuiteApps. Key functionalities now include publishing and deprecating SuiteApp versions, upgrading installations, and filtering by upgrade phase.

What's New in SuiteApp Lifecycle Management?

The SuiteApp Control Center REST API introduces significant updates aimed at automating the management of the SuiteApp lifecycle. With these enhancements, users can:

• Publish and Deprecate Versions: Utilize the new PATCH endpoint to publish a pending SuiteApp version or to deprecate a previously released version.
• Upgrade Installations: Use the PUT endpoint to upgrade SuiteApp installations to a specific version as needed.
• Advanced Filtering: The GET endpoint now includes query parameters that allow filtering of results based on managed upgrade eligibility and phase (leading or lagging). If no phase is specified, the default is set to leading.

How to Access New Features

To utilize these new endpoints effectively, you must possess the Release Manager role within NetSuite. Ensure that your role has appropriate permissions to manage SuiteApp updates.

Example API Usage

Here are examples of how to interact with the new endpoints:

PATCH Endpoint for Publishing SuiteApp Version

PATCH /services/rest/suiteapp/publish/{versionId}

• Description: This endpoint is used to publish a specific version by providing its identifier.

PATCH Endpoint for Deprecating SuiteApp Version

PATCH /services/rest/suiteapp/deprecate/{versionId}

• Description: Use this endpoint to deprecate a given SuiteApp version, effectively notifying users not to use it.

PUT Endpoint for Upgrading SuiteApp Installations

PUT /services/rest/suiteapp/upgrade/{installationId}

• Description: This endpoint upgrades a specific SuiteApp installation to the desired version.

GET Endpoint for Retrieving Installations

GET /services/rest/suiteapp/installations?upgradePhase={phase}

• Description: Retrieve installations that are eligible for a managed upgrade. Specify the upgradePhase parameter as needed.

Who This Affects

The updates to the SuiteApp lifecycle management features primarily affect:

• Developers: Who manage and deploy SuiteApps.
• Administrators: Responsible for maintaining SuiteApp configurations.
• Release Managers: Overseeing the versioning and lifecycle of SuiteApps.

Key Takeaways

• The SuiteApp Control Center REST API enhancements streamline SuiteApp lifecycle management.
• New endpoints for publishing, deprecating, and upgrading enhance automation.
• Filtering installations by upgrade phase provides targeted management capabilities.