New SuiteScript 2.1 Execution Preferences in NetSuite 2026.1

NetSuite 2026.1 introduces new SuiteScript 2.1 execution preferences, improving API support and custom tool functionalities.

·3 min read·NetSuite 2026.1·View Oracle Docs

TL;DR Opening

Starting in NetSuite 2026.1, new preferences for executing SuiteScript 2.0 scripts as SuiteScript 2.1 have been introduced. This update improves integration capabilities and enhances the overall efficiency of custom tool scripts, empowering developers to utilize the latest features of the SuiteScript framework.

What's New in February

NetSuite 2026.1 brings several enhancements that are essential for developers and administrators:

New Preference to Execute SuiteScript 2.0 Scripts as SuiteScript 2.1

This new preference allows developers to run existing SuiteScript 2.0 scripts with the enhanced features and performance of SuiteScript 2.1. By enabling this setting, users can take full advantage of the improved functionalities in version 2.1 without needing to refactor their code immediately.

HTTP and HTTPS Support for PATCH Method

The N/http and N/https modules have been updated to support the PATCH method. This is a significant addition as it allows for more flexible APIs, enabling developers to modify existing resources directly on the server with granular updates rather than full replacements.

Custom Tool Script Enhancements

Several improvements have been made to custom tool scripts and the SuiteCloud Development Framework (SDF):

  • Execution Logs: Developers can now view execution logs for custom tool scripts. This visibility into script performance is crucial for monitoring and debugging.
  • Updates Required: To utilize the logging feature, developers need to update their existing custom tool scripts. Key changes include:
    • Adding the JSDoc tag @NScriptType CustomTool.
    • Declaring entry-point functions as asynchronous.
    • Modifying SDF object XML attributes, like changing the script ID prefix.

Enhancements in Subscription Metrics Cohorts

An Acquisition Date field has been added to customer records within subscription metrics cohorts. This enhances tracking and reporting capabilities, particularly for organizations focused on understanding customer acquisition over time.

AI Connector Service Execution Log Subtab

A new subtab has been introduced in the execution log of integration records specifically for the AI Connector Service (MCP). This feature will aid in better management and monitoring of AI-related activities.

Sandbox Account Support for Exception Management

Exception management capabilities are now supported in Sandbox accounts, allowing administrators to test and refine exception-handling mechanisms without impacting live environments.

Role Restrictions Update

Role restrictions on Class, Department, and Location (CDL) on account records have been updated to include unassigned values, helping to streamline user access control across varied organizational structures.

Support for GPT-OSS Model

The N/llm module now supports the GPT-OSS model, positions developers to leverage advanced AI capabilities for their business processes.

Who This Affects

These enhancements impact various roles, primarily:

  • Developers: Particularly those involved in scripting and API integration.
  • Administrators: Who oversee the implementation of new features and security protocols.
  • Accounting and Finance staff: Particularly those using subscription metrics and requiring accurate reporting mechanisms.

Key Takeaways

  • The new preference allows SuiteScript 2.0 scripts to run with SuiteScript 2.1 features.
  • The PATCH method support in HTTP/HTTPS enhances API capabilities.
  • Execution logs for custom tool scripts improve troubleshooting.
  • Updates allow better management of exception handling in Sandbox environments.
  • AI functionality with GPT-OSS support adds value to integration efforts.

Frequently Asked Questions (4)

Can existing SuiteScript 2.0 scripts be executed as SuiteScript 2.1 without refactoring?
Yes, the new preference in NetSuite 2026.1 allows developers to run SuiteScript 2.0 scripts with the enhanced features and performance of SuiteScript 2.1 without needing to refactor their code immediately.
What additional capabilities does the support for the PATCH method in N/http and N/https modules provide?
The support for the PATCH method allows developers to modify existing resources directly on the server with granular updates, rather than needing to perform full replacements. This adds flexibility to API interactions.
What prerequisites must be met to view execution logs in custom tool scripts?
To utilize the execution logging feature for custom tool scripts, developers need to update their scripts by adding the JSDoc tag '@NScriptType CustomTool', declaring entry-point functions as asynchronous, and modifying SDF object XML attributes, such as the script ID prefix.
How does the update in role restrictions on account records help organizations?
The update to include unassigned values in role restrictions on Class, Department, and Location (CDL) streamlines user access control, allowing for more organized and effective management of user permissions across organizational structures.

Weekly Update History (1)

Release Notesupdated

Updated link to the PDF file to point to v10. For the latest version, see NetSuite 2025.2 Release Notes.

View Oracle Docs
Source: New in February Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?