12.7 Harmony release notes

12.7 Harmony release

The 12.7 Harmony release is staggered based on the dates and times as listed below by component and region. For a more detailed explanation of the release cadence by component category, see the release schedule.

App Builder 4.63 and Wevo iPaaS have separate release notes.

Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and private agents are also available.

You can subscribe to maintenance notifications for web-based components at Jitterbit Trust. Locally installed components are available from the Downloads page. Docker private agent and App Builder images are available at Jitterbit's Docker Hub. The end-of-life date for these components (except App Builder) is one year after the release date.

New features

AI agents

• QBR Deck Agent
  The QBR Deck Agent, accessed from the Marketplace AI Agent category, automates the creation of quarterly business review (QBR) presentation decks in Google Slides by gathering customer data from Salesforce, NetSuite, and product usage APIs and using AI to produce structured summaries and insights. To add it to your license, contact us.

• Security RFI Agent
  The Security RFI Agent, accessed from the Marketplace AI Agent category, automates the end-to-end processing of Security RFI (Request for Information) questionnaires to draft grounded answers from your internal knowledge bases and deliver submission-ready Word and Excel documents. To add it to your license, contact us.

Enhancements

Agent and Design Studio

• Default character encoding changed to UTF-8
  Starting with agent version 12.7 and Design Studio version 11.63, the default character encoding for the Harmony platform has changed from Latin-1 (ISO-8859-1) to UTF-8. If your integration requires a specific character encoding, configure it explicitly using the character encoding variables.

Agent

• Proxy support for native observability metrics
  A private agent's native observability feature, which reports metrics through the Management Console Agents page, now automatically inherits the agent's proxy configuration when the agent communicates through a proxy server.

• Apache Tomcat upgrade
  The Apache Tomcat server included with the agent has been upgraded to improve security and performance.

Agent, Studio, and Design Studio

• Salesforce API version 66 support
  Salesforce API version 66 (Spring '26) is now supported by the following connectors:

  • The Studio Salesforce connector automatically uses this API version for non-bulk activities when its connection is configured with OAuth 2.0 Client Credentials and used with 12.7 or later agents.

  • The Design Studio Salesforce connector supports this API version with the use of both 12.7 or later agents and Design Studio version 11.63 or later. When both these version requirements are met, an API upgrade dialog is shown when opening existing projects using this connector.

API Manager, EDI, and Harmony portal

• Expand and resize controls for AI assistant panels
  The AskJB AI, APIM AI Assistant, and EDI AI Assistant panels now include an Expand control to make the panel wider. The panels can also be manually resized by dragging the panel's left edge. When a panel is expanded, use the Minimize icon to return to the previous view.

API Manager and Management Console

• Runtime and API Logs CSV export option to include log messages
  The Download as CSV option on the Management Console Runtime page and API Manager API Logs page now opens a Download logs dialog where you can select Include messages to add full log message content to the export.

EDI

• Two-tier document type filter on the Transactions page
  On the Transactions page, the Filters pane now groups the All document types filter into two tiers: a general document type (such as Order or Invoice) that you can expand to reveal its specific subtypes, each identified by its document type code (such as 850 or 810). Select a general document type to filter by all of its subtypes at once, or select one or more subtypes to filter by only those.

• EDI AI Assistant support for querying non-compliant documents
  The EDI AI Assistant now supports searching for documents that failed compliance checks. You can optionally filter results by partner name, document type, direction, status, or date range. If 20 or fewer matching documents are found, the assistant lists the document IDs; if more than 20 are found, the assistant offers to group results by partner or refine the search.

Management Console

• Additional password policy settings editable in SSO-enabled organizations
  On the Organizations page, two User Management policies, Require special character(s) in password and Require Two-factor authentication (TFA), can now be edited after Harmony single sign-on (SSO) is enabled for an organization. These settings apply to users on the organization's Bypass SSO list.

Studio and Management Console

• AI-generated line completion in the Jitterbit script editor
  The Studio Jitterbit script editor can now display AI-generated line suggestions inline as you type, which you apply by pressing Tab. The feature is controlled by two new settings:

  • Organization policy: An organization administrator enables AI-generated line completion through the Allow full line code completion in Jitterbit script editor policy on the Studio tab of the Management Console Organizations page. This policy is disabled by default.

  • Project setting: Once the policy is enabled, the Enable full line code completion suggestion in Jitterbit script editor setting on the Advanced tab of project creation and configuration controls the feature per project.

Studio

• Diff view for selective transfer and import
  You can now preview the changes to a conflicting script or transformation before transferring or importing it. Click the View changes button to open a side-by-side comparison, with removed lines in red and added lines in green. The button appears for components in the Overwrite category during a selective transfer, and for conflicting components during a selective import.

• Project history field-level detail for connector configuration
  The project history now logs field-level detail for connector endpoint and activity configuration changes, including authentication fields.

• Projects page card view redesign
  The card view on the Projects page has been redesigned for consistency with other Harmony applications, with cards displaying endpoint icons alongside standard project information.

Studio SDK connectors

• Google Docs connector support for 3-legged OAuth
  A Google Docs connection has a new Authentication type menu where you select OAuth (newly supported) or Private-Key Based (default existing). The OAuth option uses 3-legged OAuth 2.0 (3LO) and requires a configured Management Console app registration. For setup instructions, see Google Docs 3LO prerequisites.

• Shopify connector support for 3-legged OAuth and API version 2026-04
  A Shopify connection has a new Authentication mechanism menu where you select OAuth (newly supported) or Credential-based Auth (default existing). The OAuth option uses 3-legged OAuth 2.0 (3LO) and requires a configured Management Console app registration. For setup instructions, see Shopify 3LO prerequisites. The API Version menu also now has REST Admin API version 2026-04 as a selection.

• ZoomInfo (Beta) connector support for 3-legged OAuth
  A ZoomInfo connection has a new Authentication menu where you select Authorization Code Flow (newly supported) or Client Credentials Flow (default existing). The Authorization Code Flow option uses 3-legged OAuth 2.0 (3LO) and requires a configured Management Console app registration. For setup instructions, see ZoomInfo 3LO prerequisites.

Changes

Agent

• Updated CPU capability default values for private agents
  The default values of CpuConsecutiveFailureThreshold and CapabilityRefreshCooldown in the [AgentCapability] section of jitterbit.conf have changed:

  • CpuConsecutiveFailureThreshold (introduced in 12.6) now defaults to 3 (previously 1), requiring three consecutive CPU threshold violations before the agent transitions from Capable to Incapable.

  • CapabilityRefreshCooldown now defaults to 1 (previously 2), reducing the cooldown period in seconds before capability status refreshes after the agent becomes incapable.

API gateway

• General changes
  The API gateway has general changes for maintenance and performance.

Studio SDK connectors

• Removal of deprecated OpenAI models
  Six deprecated OpenAI models have been removed from the Model dropdown in the OpenAI Prompt and Register Tools activities: gpt-4-turbo-preview, gpt-4-vision-preview, gpt-4-32k, gpt-3.5-turbo-instruct, babbage-002, and davinci-002. These models are no longer supported by OpenAI and would return errors if used.

Fixes

Agent and Design Studio

• Multibyte character fixes
  The following fixes resolve issues with operation failures, incorrect output, incorrectly displayed characters, and inaccessible files and backups.

  These fixes apply when using agent version 12.7 or later:

  • The WriteToOperationLog function now writes multibyte characters to the operation log correctly. Previously, these characters were corrupted.

  • The GetEnvironmentName function now returns multibyte characters correctly, so comparisons against environment names that contain them succeed.

  • The StringLength function now counts multibyte characters correctly rather than counting bytes. A new jitterbit.script.string.utf8size variable controls this behavior and defaults to true; set it to false to use the legacy byte count.

  • The ToLower, ToUpper, and ToProper functions now convert the case of multibyte characters correctly. Previously, they could leave a multibyte character's case unchanged or incorrectly change the case of an adjacent character.

  • Fixed-width text files now calculate field widths by character count rather than byte count, so multibyte characters no longer shift column positions. A new jitterbit.text.fixed_width_use_byte_length variable controls this behavior and defaults to false; set it to true to use the legacy byte-based width.

  • Operation schedules whose names contain multibyte characters no longer fail to run. Previously, certain characters in a schedule name could interrupt the agent's database connection and prevent the operation from executing on the schedule.

  These fixes require both agent version 12.7 or later and Design Studio 11.63 or later:

  • NetSuite query operations that contain multibyte characters no longer fail with an XML parsing error.

  • The Test web service call feature now displays multibyte characters correctly in the target.

  • Project backups deployed with multibyte characters in the deployment tag can now be downloaded from the Management Console Projects page.

Agent

• Improved agent stability under concurrent API request processing
  Agents are more resilient when handling concurrent API-triggered requests, resolving a crash that could occur during processing.

• FromDataLoaderDateTime function now parses European-format dates
  The deprecated FromDataLoaderDateTime function in Design Studio now correctly parses European-format dates using a dot (DD.MM.YYYY) or hyphen (DD-MM-YYYY) as the date separator. Previously, these formats returned error 1007 Unparseable date.

API Manager

• Regenerate Docs no longer produces empty OpenAPI documentation
  The Portal Manager Regenerate Docs button now generates OpenAPI documentation for all custom and proxy APIs in an environment. Previously, generating documentation for an environment whose API services referenced certain operations could produce a specification with no operations defined.

• Wildcard search in API log messages is now supported
  The Queries search bar on the API Logs page now correctly handles the % wildcard character in message filter searches. Previously, using % in a message search (for example, message=%final client%) caused an error and returned no data.

• Large API log CSV downloads no longer error
  The Download as CSV option on the API Logs page now successfully generates and downloads CSV files for large datasets. Previously, downloading API logs for large date ranges or high record volumes resulted in errors such as CSV file is still being generated. Please try again later and An error occurred while generating the CSV file.

Management Console

• Deleting an environment now removes associated resources
  Deleting an environment from the Management Console Environments page now automatically deletes all associated Cloud Datastore storages, message queues, and client certificates. Previously, deleting an environment could leave orphaned resources that could no longer be edited or deleted, causing logout errors when accessed.

Studio

• Improved project loading performance
  Opening a project in Studio is now significantly faster in environments with a large number of projects and operations.

Studio SDK connectors

• BMC Helix ITSM connector SSLException error resolved
  An intermittent SSLException: Connection reset error that occurred during HTTPS calls made by the BMC Helix ITSM connector in certain cases has been resolved.

• HTTP v2 connector OAuth 2.0 Client Credentials now supports token endpoints that omit expires_in
  The HTTP v2 connector's Client Credentials Grant OAuth 2.0 type now generates an access token when the OAuth token endpoint's response does not include an expires_in field. Previously, token generation failed against endpoints that omit this field.

• OpenAI Create Image activity now generates images using gpt-image-2
  The OpenAI Create Image activity previously used the deprecated dall-e-2 model, which caused the activity to fail. The activity now uses the gpt-image-2 model and includes new optional settings: Output Format (jpeg, png, webp), Number of Images, Quality, Output Compression, Moderation, and Background. Image data is returned as a Base64-encoded JSON string (b64_json); URL-format responses are no longer supported.

Notices

Agent

• Retirement of 11.x private agent versioning
  The 11.59 / 12.3 release included the final 11.x private agent version (11.59) and the first available 12.x private agent version (12.3). Note the following regarding future releases:

  • Final 11.x version: The 11.x private agent version has reached the end of its planned development. All future enhancements, new features, and security updates will be delivered through 12.x private agents. While 11.x agents may receive rare critical fixes for production-impacting issues, no ongoing releases are planned.

  • Recommendation: We strongly recommend upgrading to 12.x private agents as soon as possible to benefit from the latest performance, security, and feature improvements.

  • Upgrade path: You can upgrade directly from 11.x to any 12.x version using our documented upgrade instructions: Windows, Linux, or Docker.

Agent and API gateway

• End of life for version 11.45
  As of June 26, 2026, these product versions have reached end of life and are no longer supported:

  • Private agent version 11.45

  • Private API gateway version 11.45

  We recommend that users of these versions upgrade to the latest version as soon as practicable.

Studio SDK connectors

• Action required: Upcoming removal of deprecated Cloud Datastore Query Items activity
  In an upcoming release, the deprecated Query Items activity in the Cloud Datastore connector will be permanently removed. This activity was replaced in the 11.47 release by the redesigned Query Items activity, whose flattened response structure returns the individual fields you define in the Management Console Cloud Datastore page directly at the top level of the response.

  Important

  If you are using the deprecated Query Items activity in any operations, you must review your operation design and replace it with the redesigned Query Items activity as soon as possible. The deprecated activity is no longer supported and will be removed in a future release.