Error "Attempted to handle event reloadRecord" When Changing a Workspace VCS Branch

Problem

When you update a workspace's version control settings to change the VCS branch in Terraform Enterprise, the UI may display the following error:

Attempted to handle event `reloadRecord` on <workspace-v2:ws-wvgZ32uUU7wzDhbi> while in state root.loaded.updated.inFlight. Called with { resolve: [Function], options: { adapterOptions: { include: "current_run,current_configuration_version,current_state_version,outputs,readme," } } }.

Prerequisites

• Terraform Enterprise version v202309-1

Cause

This error is caused by a known bug in Terraform Enterprise version v202309-1.

Solutions

There are two approaches to resolve this issue. The first is a temporary workaround, and the second is the recommended permanent solution.

Solution 1: Refresh the Browser Page

As a temporary workaround, you can refresh the page in your web browser. After the refresh, the error message should disappear, and the UI should reflect the updated branch.

Solution 2: Upgrade Terraform Enterprise

The permanent solution is to upgrade your Terraform Enterprise instance to version v202310-1 or a later release. This version contains the fix for this bug.

Outcome

After upgrading Terraform Enterprise or refreshing the page, you can switch a workspace's VCS branch without triggering the reloadRecord error.

Additional Information

• For more details on releases, refer to the Terraform Enterprise Releases documentation.