12.10 Harmony release notes

12.10 Harmony release

The 12.10 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.66 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, private API gateway, 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

Studio SDK connectors

• Anthropic Claude connector
  The Anthropic Claude connector is now generally available. It can be used with cloud or private agents to send prompts to and register tools with Claude models hosted by Anthropic directly or through Amazon Bedrock.

• PDF Utilities connector
  The PDF Utilities connector is now generally available. It can be used with cloud agents or private agent version 12.3 or later to generate PDF documents, with no external API or outbound network calls required. The connector's Convert Text to PDF and Convert HTML to PDF activities convert plain text or HTML content into a PDF document.

Enhancements

Agent

• PostgreSQL upgrade for Windows private agents
  The PostgreSQL version bundled with Windows private agents has been upgraded to improve security and stability.

• Oracle and PostgreSQL JDBC driver upgrade
  The agent-bundled JDBC drivers for Oracle and PostgreSQL have been upgraded to improve compatibility for Database connections in Studio and Database sources and targets in Design Studio.

Agent, Studio, and Design Studio

• Salesforce API version 67 support
  Salesforce API version 67 (Summer '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.10 or later agents.
  • The Design Studio Salesforce connector supports this API version with the use of both 12.10 or later agents and Design Studio version 11.66 or later. When both these version requirements are met, an API upgrade dialog is shown when opening existing projects using this connector.

API Manager

• Advanced Search on the APIs page
  The previous left-side Filter panel on the APIs page is replaced by two search modes, aligning with the search experience already used on the API Logs page:

  • Simple Search: The existing search bar instantly filters the displayed APIs table by matching entered text across all displayed columns.
  • Advanced Search: Click the icon next to the search bar to open a panel where you can combine built-in filters, such as API Type, API Status, Environment, and Last Published, and save the combination as a reusable search. Opening this panel clears any active Simple Search text, and resetting it returns to the default APIs list.

• Confirmation before clearing the OpenAPI document in Proxy APIs
  In the Existing API tab of a proxy API configuration, clicking Clear now shows a confirmation prompt before removing a provided OpenAPI document. Clearing the document also removes any automatically discovered services generated from it, but does not affect manually added services or other API settings.

EDI

• AS2 connection support for binary Content-Transfer-Encoding
  An AS2 connection now accepts binary values (in addition to the previously supported base64 values) for the Content-Transfer-Encoding header on incoming messages, so it works with trading partners regardless of which encoding their AS2 endpoint uses.

• LF and CR options for the X12 Segment Separator (ISA18)
  The Segment Separator (ISA18) field on the Separators tab of a partner's X12 EDI settings now accepts a value of LF or CR in addition to a single character. Outbound X12 documents for that partner are then generated using a line feed (hex 0A) or a carriage return (hex 0D) to separate segments.

• Partner ID character limits by EDI standard
  A trading partner's Partner ID now accepts the ID lengths your partner specifications call for, with limits specific to each EDI standard:

  • X12: A fixed two-character qualifier plus an ID of 1–15 characters.
  • EDIFACT: A qualifier of 1–4 characters plus an ID of 1–35 characters.
  • TRADACOMS: Exactly 12 characters.

  Your own EDI ID uses one format for every standard: an optional qualifier of up to 4 characters plus an ID of 1–35 characters. The Qualifier and Qualifier Code fields are also now free text, so you can enter any valid qualifier code.

Management Console

• Cloud logging alert and external alert recipients
  The Alerts page includes the following enhancements:

  • Cloud logging status changed: A new Cloud logging status changed event notifies designated recipients when Cloud logging is enabled or disabled for a private agent group.
  • External recipients: An alert's Recipients field now accepts external recipients alongside registered Harmony users. External recipients are email addresses that aren't associated with a Harmony user account, and they receive only the alert email, with no Harmony account or platform access.

• Edit and deployment history on the Projects page
  The Management Console Projects page's Projects table has four new columns showing who last edited or deployed a project and when: Last Edited, Edited By, Last Deployed, and Deployed By. This information was already available in Studio's Projects list view. These columns are hidden by default; use the Filter Columns drawer to show, hide, or reorder them.

• Console AI Assistant support for message queues
  The Console AI Assistant (Beta) can now list, search, create, duplicate, purge, and delete message queues, and list, search, create, and deactivate authentication tokens, using natural language.

Studio

• Expanded diff view in project history and selective transfer
  The diff view for tracking component changes now covers more component types:

  • Project history: Field-level diffs are now available for tools, email notifications, operations, project variables, and connector endpoints and activities, shown in a Name, Before, and After table with linked variable references, masked credential fields, and expandable details for long or complex values. The diff view, accessed by clicking the View changes icon, is only available for connector endpoints created after the 12.10 release.
  • Selective transfer: Connector endpoint and activity components in the Overwrite category now show a table comparing configuration field values between the source and target environments, with sensitive values masked.

• Design canvas placement for operations added by selective transfer
  A new operation created by a selective transfer is now added directly to the target project's design canvas, in the same position relative to its neighboring operations as in the source project. Any operation chains connecting it to other operations are preserved. Previously, the operation appeared only in the project pane's Components tab and had to be dragged onto the canvas manually.

Studio SDK connectors

• Azure OpenAI connector verified with GPT-5.6 models
  The Azure OpenAI connector is verified to support the GPT-5.6 model family. These models are selectable once you deploy them in your Azure OpenAI resource.

• HTTP v2 connector support for custom OAuth grant type values
  An HTTP v2 connection's OAuth 2.0 Client Credentials Grant configuration has a new Grant type request parameter menu, available when the Client Credentials grant type is selected. Select Custom to enter your own grant_type value in the new Custom grant type value field, instead of the default client_credentials value, for OAuth services that require a non-standard value.

• MCP Client connector support for MCP protocol version 2026-07-28
  An MCP Client connection's Protocol Version menu has a new 2026-07-28 option. After changing an existing connection to this version, regenerate activity schemas to use the updated response schemas.

• OpenAI connector support for GPT-5.6 models
  The OpenAI Prompt (Deprecated), Prompt V2, Register Tools (Deprecated), Register Tools V2, and Register MCP Server Tools activities now support the GPT-5.6 model family: gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna. The Temperature and Top Probability settings on the Prompt and Prompt V2 activities are not supported with these models.

Changes

Agent

• JDBC connection restrictions for database connections
  Agents now restrict JDBC connections used by the Database connector in Studio and Database sources and targets in Design Studio by default, for security reasons: connections to localhost or 127.0.0.1 are blocked, and specific connection string parameters are blocked or restricted for MySQL, PostgreSQL, Oracle, and SQL Server. To allow a database on the same host as the agent or a specific blocked parameter, update the corresponding key in the [JdbcSecurity] section of the agent configuration file (jitterbit.conf), then restart the agent.

API gateway

• User identifier validation for API logs
  For security reasons, the value recorded to identify who made an API request can no longer contain disallowed characters. A request fails with an INVALID_TRIGGER_USER error if this value contains one of these characters. To resolve this error, check which of the following applies:

  • Basic authentication with the default Logging setting: Update the security profile's User name field to remove the disallowed characters, then update the credentials in any calling application that references the previous username.
  • Custom Logging setting: Update the calling application to send a header value that doesn't contain the disallowed characters.

EDI

• Company ID renamed to EDI ID
  Your own EDI ID is now named consistently in the EDI user interface, replacing the Company ID and Company ISA ID labels:

  • On a partner's EDI settings tab, the Company ID panel is now EDI ID, and the Preferred IDs section is now Preferred ID (ISA ID's).
  • The dialog that opens for your first partner in an environment is now Generating Your EDI ID, and its Company ISA ID field is now EDI ID.

Studio SDK connectors

• OpenAI Prompt and Register Tools activity deprecation
  The OpenAI Prompt and Register Tools activities are now marked (Deprecated) in Studio and are no longer supported. Both were replaced in the 12.8 release by the redesigned Prompt V2 and Register Tools V2 activities.

Fixes

Agent

• Agent stability improvements
  This release resolves several issues that could cause the agent's Apache process to crash, including under heavy processing load.

  • Scripts that call a child operation using RunOperation while the parent and child operations access the same global variable no longer crash the agent.
  • Transformations configured with chunking and multiple threads remain stable when one thread finishes running before another thread that started at the same time.
  • Operations with component input and output data generation enabled no longer crash the agent when multiple such operations run at the same time.

• jitterbit.operation.warning now populates when an FTP source finds no files
  When an FTP source finds no files to process, the jitterbit.operation.warning variable now populates with a warning message, including when checked from a parent operation that called the affected operation as a child (for example, using RunOperation). Previously, this variable did not populate for this scenario.

• Windows private agent upgrade fixes
  Two fixes improve upgrading a Windows private agent from version 11.x to 12.10 or later:

  • An advanced installation upgrade no longer fails with Error 1720 when the existing PostgreSQL service uses an account other than jitterbitpostgres.
  • The previous version's PostgreSQL service is now removed after a successful upgrade, rather than remaining enabled and starting automatically on the next system restart, which could prevent the new PostgreSQL service, and the agent, from starting.

• Metrics service now uses the agent's PgBouncer port after an upgrade
  Upgrading a private agent now updates the connection the metrics service uses to report the PGBouncer status metric so it matches the agent's own PgBouncer port. Previously, upgrading could leave this connection on the wrong port, causing the PGBouncer metric to report incorrectly even though PgBouncer itself continued to run normally.

• Multibyte character fixes
  The following fixes resolve issues with unreliable output and data corruption.

  • A multibyte character used as a field delimiter in a text file format now parses reliably in a transformation.
  • A multibyte character appearing farther into a large JSON connector response is no longer corrupted. Previously, character-encoding auto-detection sampled only the beginning of the response, so if that initial portion contained only ASCII characters, the response was incorrectly detected as Latin-1 (ISO-8859-1) instead of UTF-8, corrupting any multibyte character appearing beyond the sampled portion.

API gateway

• API gateway requests to older private agent versions now process correctly
  API requests processed through the API gateway to older private agent versions no longer intermittently fail with a 502 error.

API Manager, Studio, and Management Console

• Log date pickers now limited to the log retention period
  The custom date pickers in the Studio operation logs view, on the Management Console Runtime page, and on the API Manager Analytics and API Logs pages now allow you to select dates only within the past 30 days, matching the retention period for operation logs, API logs, and API metrics. Previously, dates within the past 90 days could be selected, but no data was returned for dates outside the retention period.

Harmony platform

• Submitted operations recover reliably after an agent outage
  An operation submitted while its agent group was temporarily unavailable now retries and resumes shortly after the agent group recovers, rather than remaining in Submitted status until it's automatically canceled. If the agent group stays unavailable long enough for retries to be exhausted, the operation now transitions cleanly to Error instead. Canceling an operation that's still in Submitted status, with no agent yet assigned, now also takes effect immediately instead of waiting for that same automatic cleanup.

Studio

• Restoring a project to its currently deployed version no longer marks operations as undeployed
  Restoring a project to the version that is currently deployed now shows the project's operations as deployed. Previously, all operations displayed the Undeployed icon after the restore, even though the restored state matched what was deployed. This fix applies only to projects deployed after the 12.10 release; restoring to a version deployed before the 12.10 release continues to show operations as undeployed.

• Salesforce bulk operation write and send settings now persist after project migration
  The Salesforce bulk operation options (Write success records to, Write failure records to, Send success records to, and Send failure records to) are now preserved when the project is migrated to another environment. Previously, these settings could be cleared during migration and had to be manually reconfigured.

Studio and Management Console

• Project names can no longer be saved with leading or trailing spaces
  A project name can no longer be saved with a leading or trailing space. Previously, a project name saved with a trailing space could not be found using the project= query term on the Management Console Runtime page, even when the query value also included the trailing space. Existing projects with a leading or trailing space in their name are not corrected automatically; to fix one, open Edit project settings for that project and click Save, which trims the name and restores the ability to match it with a project= query.

Studio SDK connectors

• Query and List Channels activity Basic mode date filters now support variables
  The Basic tab of the following connector activities now correctly builds the Filter String when a date field's filter value uses a global variable, project variable, or Jitterbit variable instead of a hardcoded value. Previously, using a variable in a date field's Basic tab filter caused an invalid date error in Studio before the query reached the connector.

  • Epicor Prophet 21 Query
  • Microsoft Entra ID Query
  • Microsoft Teams List Channels
  • Microsoft SharePoint 365 Query
  • Microsoft Dynamics 365 Business Central v2 Query
  • OData Query
  • SAP SuccessFactors Query

• BigCommerce Query activity response schema now includes date_last_imported
  A BigCommerce Query activity configured with the Catalog object > Get All Products sub-object now includes the date_last_imported field in its generated response schema. Previously, this field was missing from the schema even though BigCommerce returned it in the response, so the operation completed with a Success with info status and a warning stating extra subelement "date_last_imported" under the element "item".

• SAP connector schema refresh no longer fails with a null pointer error
  Refreshing the request and response schemas for an SAP function in Studio's SAP connector or Design Studio's SAP connector no longer fails with a NullPointerException (Failed to download the request and response schemas) on 12.x agents. The issue did not affect 11.x agents.

• Shopify connector API 2026-07 support
  A Shopify connection's API Version menu now has REST Admin API version 2026-07 as a selection. If updating an existing connection, see steps for changing the API version.

• Snowflake Merge and Update now handle commas, quotes, and newlines in field values
  The Snowflake Merge and Update activities using the Direct Mapping or Use Temporary Stage approach now correctly quote and escape field values containing a comma, double quote, or newline. Previously, these characters could corrupt the underlying CSV row when unescaped, misaligning columns and causing errors such as a failed date or timestamp parse.

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.

  Actions required: Plugin updates and verification of custom connectors for 12.x private agents

  • Plugin updates for 12.x private agents
    Performance and security enhancements for 12.x private agents are incompatible with the Multipart Pipeline and AWS S3 Create Plugins. If you use these plugins, user action is required as described in the upgrade instructions.
  • Verification of custom connectors for 12.x private agents
    Connector SDK connectors that are provided by a third party must undergo development changes to be compatible with 12.x private agents. Before upgrading to 12.x private agents, verify compatibility with the connector developer, or operations using those connectors will begin failing at the time of upgrade.

• End of life for version 11.48
  As of August 28, 2026, private agent version 11.48 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

Studio SDK connectors

• Action required: Deprecation of OpenAI Prompt and Register Tools activities
  The OpenAI Prompt and Register Tools activities are now deprecated and no longer supported, and will be permanently removed in an upcoming release. Both were replaced in the 12.8 release by the redesigned Prompt V2 and Register Tools V2 activities, whose use of OpenAI's Responses API makes it possible to persist chat context and call registered tools on cloud agent groups, not just private agents.

  Important

  If you are using the Prompt (Deprecated) or Register Tools (Deprecated) activity in any operations, you must review your operation design and replace it with the Prompt V2 or Register Tools V2 activity as soon as possible, as the deprecated activities are no longer supported and will be removed in the future.

• 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.