n8n_workflow_versions

Overview

The n8n_workflow_versions tool provides comprehensive version management for n8n workflows. It allows you to view version history, rollback to previous states, and manage version storage.

Requires N8N_API_URL and N8N_API_KEY to be configured.

Parameters

mode

string

required

Operation mode. One of: list, get, rollback, delete, prune, truncate

workflowId

string

Workflow ID (required for list, rollback, delete, prune modes)

versionId

number

Version ID (required for get mode and single version delete, optional for rollback)

limit

number

default:"10"

Maximum versions to return in list mode

validateBefore

boolean

default:"true"

Validate workflow structure before rollback

deleteAll

boolean

default:"false"

Delete all versions for workflow (delete mode only)

maxVersions

number

default:"10"

Keep N most recent versions (prune mode only)

confirmTruncate

boolean

default:"false"

REQUIRED: Must be true to truncate all versions (truncate mode only)

Modes

View version history for a workflow

# List last 10 versions
{
  "mode": "list",
  "workflowId": "workflow-123",
  "limit": 10
}

Get details of a specific version

{
  "mode": "get",
  "workflowId": "workflow-123",
  "versionId": 5
}

Restore workflow to a previous version

Creates a backup of the current version before rolling back.

{
  "mode": "rollback",
  "workflowId": "workflow-123",
  "versionId": 5,
  "validateBefore": true
}

Delete specific version or all versions

# Delete single version
{
  "mode": "delete",
  "workflowId": "workflow-123",
  "versionId": 5
}

# Delete all versions
{
  "mode": "delete",
  "workflowId": "workflow-123",
  "deleteAll": true
}

Keep only N most recent versions

{
  "mode": "prune",
  "workflowId": "workflow-123",
  "maxVersions": 10
}

Delete ALL versions for ALL workflows

This is a destructive operation that cannot be undone. Requires confirmTruncate: true.

{
  "mode": "truncate",
  "confirmTruncate": true
}

Response

mode

string

The operation mode that was executed

workflowId

string

Workflow ID (for list, get, rollback, delete, prune modes)

versions

array

Array of version objects (list mode)

Show Version object

versionId

number

Version identifier

createdAt

string

Timestamp when version was created

nodes

number

Number of nodes in this version

active

boolean

Whether this version is currently active

version

object

Version details (get mode)

success

boolean

Whether the operation succeeded

message

string

Operation result message

Use Cases

Audit Trail

Track all changes made to a workflow over time. View who made changes and when.

Safe Rollback

If a workflow update causes issues, quickly rollback to a previous working version.

Version Cleanup

Prune old versions to save storage space while keeping recent history.

Disaster Recovery

Restore workflows to known-good states after configuration errors or bugs.

Best Practices

Before rolling back, validate the target version to ensure it will work with your current n8n setup.

Always keep at least a few recent versions as backups. Don’t prune too aggressively.

Version history is maintained automatically by n8n when workflows are updated.

n8n_get_workflow - Retrieve current workflow state
n8n_update_full_workflow - Update workflow (creates new version)
n8n_autofix_workflow - Fix common errors before rollback

MCP Tools

Workflow Management

Execution Management

Library API

n8n_workflow_versions

Overview

Parameters

Modes

Response

Use Cases

Best Practices

Build docs developers (and LLMs) love

MCP Tools

Workflow Management

Execution Management

Library API

​Overview

​Parameters

​Modes

​Response

​Use Cases

​Best Practices

​Related Tools

Build docs developers (and LLMs) love

Overview

Parameters

Modes

Response

Use Cases

Best Practices

Related Tools