Maintenance Mode

Pause one workspace's pipelines and suspend its connections during planned work, while other workspaces on the instance keep running.

Where

Overview status pill · Workspaces list

Who

Workspace.Admin or a platform administrator

Running runs

Cancelled

Reason

Required, up to 500 characters

Maintenance mode pauses one workspace's work so you can upgrade equipment, migrate a database, or do other planned work safely. It applies to a single workspace. Other workspaces on the same instance keep running.

While maintenance mode is on for a workspace:

• Pipelines: no new pipeline work starts. Triggers, schedules, webhooks, manual runs, retries, node emits and queued items are held back. Pipeline executions that are already running when you turn maintenance on are sent a cancellation. They do not run to completion.
• Connections: every connection in the workspace is suspended. Nothing is deleted. While maintenance is on, nobody can start or resume the workspace's connections. They are told that the workspace is in maintenance.

When you turn maintenance mode off, pipeline work can start again and the connections that maintenance suspended are resumed automatically. Connections that someone had already suspended or stopped before maintenance began stay as they were.

Where to find it

• Workspace Overview: the status pill in the page header, next to the workspace's name, shows Operational or Maintenance. Click it to open the Maintenance Mode dialog. Every member of the workspace can see the state.
• Maintenance banner: while maintenance is on, a banner at the top of every page says so. Its Manage button opens the same dialog.
• Workspaces list (platform administrators): each workspace's actions menu has Enter maintenance or Exit maintenance. You can turn maintenance on or off for any workspace without switching to it. A workspace in maintenance shows In maintenance in the list, with its reason.

Only users who can update the workspace (Workspace.Admin, or a platform administrator) can turn maintenance mode on or off. For everyone else the switch is disabled, with a note explaining why.

Enabling Maintenance Mode

1. Open the Maintenance Mode dialog from the Overview pill, or choose Enter maintenance in the Workspaces list.
2. Move the switch from Operational to Maintenance.
3. The confirmation dialog lists what will happen: running pipeline executions are cancelled, new pipeline work is held back, and every connection is suspended. Enter a reason (required, up to 500 characters), for example "Scheduled system updates" or "Database migration in progress".
4. Click Enable Maintenance Mode.

Maintenance mode takes effect immediately. Every open browser session sees the change within about 30 seconds.

warning

Turning maintenance mode on cancels the pipeline executions running in the workspace at that moment. Work those executions already completed stays done, such as database writes, published messages and API calls. Before you turn maintenance on, make sure that no time-critical pipeline is partway through.

Disabling Maintenance Mode

Move the switch back from Maintenance to Operational, or choose Exit maintenance in the Workspaces list. Enter a reason (for example "Maintenance completed") and confirm. Pipeline work can start again, and the connections that maintenance suspended are resumed.

tip

Always give a meaningful reason. It is recorded in the maintenance history and helps your team understand past maintenance windows during audits or troubleshooting.

Connections during maintenance

On the Connections page, a connection that maintenance suspended shows Suspended — workspace in maintenance, with a note that it resumes automatically when maintenance is turned off. A connection that a person suspended keeps the usual Suspended status and shows the reason that person gave.

Maintenance History

Below the switch, the Maintenance History table lists every change to the workspace's maintenance mode:

Column	Description
Status	A color indicator: red for enabled, green for disabled.
Action	Whether maintenance mode was enabled or disabled.
Reason	The reason the administrator gave.
Timestamp	The date and time of the change.
User	The administrator who made the change.

If there are many records, use Previous and Next to move between pages.

How It Works

When maintenance mode is turned on for a workspace:

1. The workspace's settings are updated and the change is recorded in its settings history.
2. A maintenance event is published on the internal event bus.
3. Every engine replica stops starting new pipeline work for the workspace and sends a cancellation to its running executions.
4. The connectors module suspends every connection of the workspace and records the suspension as made by maintenance.

When maintenance mode is turned off, the engine starts accepting pipeline work for the workspace again. The connectors module resumes only the connections that maintenance suspended.