Skip to content

Releases

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:44
c9aeb34

What's Changed

Features

  • feat: support n8n 2.47.3 Public API (rate limits, promotions scopes, package import fields) by @SomeoneWithOptions in #46

Full Changelog: v0.5.0...v0.6.0

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 07:52
0267901

What's Changed

Features

Fixes

Full Changelog: v0.4.0...v0.5.0

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 17:50
a9fe2f4

Aligns the CLI with n8n Public API spec 1.1.1: 26 new operations, several write-path fixes, and retry-safe mutations. 184 operations covered.

Breaking changes

  • promotion apply no longer reports a blocked apply as success. The result now follows the server status (applied / blocked / source-changed); blocked and source-changed exit non-zero and print the preflight details. Previously it printed Applied: and exited 0 even when nothing was written.
  • community-package install|update --verify removed from the request. The spec dropped the field; the instance setting now controls unverified installs. The flag still parses but is hidden and prints a deprecation.
  • user list --offset deprecated. The server ignores it; use --cursor. Flag is hidden and ignored.
  • node-policy set warnings carry kind (shadowed | notLoaded) in JSON and text output; shadowedByRuleId is omitted when empty.
  • package export body field rename. --dependency-policy / --version-policy replace --missing-workflow-dependency-policy / --workflow-version-policy (old flags work as hidden aliases). Before this, every export with a policy flag failed with 400.
  • Library: Client.CreateProject takes CreateProjectRequest; n8n.DataTableCreateColumnTypes removed.

Features

  • --idempotency-key KEY|auto on workflow create, execution stop|stop-many|retry, data-table row insert|upsert, package import|import-selection, promotion apply|promote|apply-continue and promotion project apply|promote|apply-continue. Sends the Idempotency-Key header so a retry after a timeout returns the first result instead of running twice. auto generates a UUID and prints it on stderr. 422 (key reused with a different body) and 409 (original still running) get actionable errors. The CLI never retries on its own.
  • credential-policy command group: reusable credential type policy documents (document list|get|create|set|delete), scope attachments (attachment get|set), and instance/project credential policies (instance|project get|set).
  • node-policy document … and node-policy attachment …: reusable node type policy documents and scope attachments, mirroring the credential ones.
  • package import-selection: import selected workflows from one source project of a project package (--project-id, repeatable --workflow-id / --delete-workflow-id, conflict/ID/deletion policies). Additive; deletes only the listed IDs.
  • promotion project changes|apply|promote: project-scoped sync of selected workflows through the project's resolved Git connection.
  • promotion apply-continue and promotion project apply-continue: resume a blocked apply after bindings are set up, with --expected-from FILE|- or explicit expected-source flags.
  • promotion provider repositories|branches: discover repositories and branches with search and cursor collection.
  • GitLab providers accepted on promotion provider commands.
  • user delete --transfer-to-project PROJECT_ID: move the user's workflows and credentials instead of deleting them.
  • project create gains --id, --description, --icon TYPE:VALUE, --icon-color, --telemetry-tag KEY=VALUE; reads keep icon, description, telemetry tags, creator and timestamps.
  • credential create input accepts description and a custom id; credential update accepts description (null/blank clears). Reads keep description and usageScope.
  • workflow list --include-parent-folder: adds a FOLDER column and parentFolder in JSON.
  • saml set: --email-verified-required and --email-verified-attribute for the now-required emailVerifiedRequired / mapping.emailVerified fields; get | set --input - round-trips.
  • otel set: --emit-workflow-start-span / --emit-node-start-span; previously every set silently turned both off.
  • community-package install accepts scoped names (@scope/n8n-nodes-name).

Fixes

  • 403 license denials are reported as such, not as a missing scope. When the server says feat:<name>, the error names the unlicensed feature and the scope hint is dropped (variables, projects, LDAP, SAML, OIDC, security policy, log streaming, role mapping, promotions, node policies).
  • evaluation case list failed to decode numeric executionId; now accepts numbers and numeric strings.
  • workflow create|update|copy: description is kept instead of being dropped; parentFolderId: null is sent to move to project root; read-only "DEFAULT" settings and node createdAt/updatedAt are stripped and reported on stderr; null settings is sent as {}.
  • workflow update|publish|copy 403/409 errors name the saved draft or blocking review instead of guessing.
  • data-table: json column type refused locally with a hint; --sort-by and column names validated before the request.
  • variable: key, value and project ID limits validated locally; update help no longer claims omitting --project-id moves to global.
  • folder: name and ID length limits validated; --parent-folder-id 0 documented as "move to project root".
  • node-policy set --input no longer fails on warnings from a previous set or raw API output.
  • community-package update without --version sends no body and updates to the latest allowed version.
  • package import: aligned with the 1.1.1 body and conflict/unprocessable (409/422) responses.
  • Coverage: 29 operationId renames synced; git-connection ops marked retired (declared by no current spec, kept for older instances); promotions and node policies now both.

What's Changed

Full Changelog: v0.3.6...v0.4.0

v0.3.6

Choose a tag to compare

@github-actions github-actions released this 30 Sep 01:12
6d6640a

Features & Improvements

  • --quiet and --brief for list commands: n8n workflow list, tag list, credential list, project list, and execution list get two text views for scripts. Neither prints a header. --quiet prints one ID per line. --brief prints the ID and a few key fields, tab-separated: name for workflows and tags, name and type for credentials and projects, workflow ID and status for executions. Backslash, tab, newline, carriage return, and other control characters in fields are escaped as \\, \t, \n, \r, and \uXXXX. Only rows go to stdout. The next cursor and any empty-result hint go to stderr. You can't combine the two flags, and neither works with --output json. Both are checked before any request is sent.
  • Better --all reporting: every list command that supports --all now says whether the walk finished or stopped at the 10,000-item cap. With --output json, the result has a new collection object (truncated, limit) so a script can tell a complete list from a capped one without reading stderr. nextCursor is set only when resuming from it can't skip an item, and n8n folder list adds nextSkip for offset resume. At the cap, stderr prints a warning with resume steps, also in --quiet/--brief mode. n8n folder list --all keeps count as the server's total and now errors if the pages it gets back don't add up to the total the server reports.

What's Changed

Full Changelog: v0.3.5...v0.3.6

v0.3.5

Choose a tag to compare

@github-actions github-actions released this 24 Sep 20:23
5ccd68b

Features & Improvements

  • Multiple --status values for n8n execution list: --status now accepts several statuses, comma-separated (--status error,crashed) or repeated (--status success --status error). Each status is validated before any request is sent. The API filters one status per request, so the CLI fetches each status separately (one paged walk each with --all), merges results newest first, and caps them at --limit (default 30 with several statuses) or 10,000 with --all. --cursor still requires a single status. With --include-data, it fetches up to --limit detailed rows per status and shows --limit of them.

What's Changed

Full Changelog: v0.3.4...v0.3.5

v0.3.4

Choose a tag to compare

@github-actions github-actions released this 23 Sep 02:51
f106f05

Features & Improvements

  • N8N_CONTEXT environment selection: context resolution precedence is now --context, then N8N_CONTEXT (empty string counts as unset), then saved current context. Resource commands, n8n auth status, and n8n auth logout reject unknown selections without persisting environment choice; n8n auth login resolves name identically (fallback default) and selects saved context on success. Workflow copy and diff continue using saved contexts only.
  • n8n config context rename: new CLI-only command to rename saved context (n8n config context rename OLD NEW) without altering credential identities. Operates through crash-safe lifecycle service using staged credential migration and file locking across rename, login, logout, use, and delete.

What's Changed

Full Changelog: v0.3.3...v0.3.4

v0.3.3

Choose a tag to compare

@github-actions github-actions released this 22 Sep 02:55
078d884

Features & Improvements

  • n8n auth login --skip-verify: save a credential without the remote /discover verification check — for offline setup, instances without discovery, or narrowly scoped keys lacking discovery access. Skips only the remote check: local validation, storage consent, and replacement confirmation still apply. A wrong URL or invalid credential can be saved; access is checked on the first resource request. After saving, inspect with n8n auth status or verify a real command (e.g. n8n user list --limit 1).

What's Changed

Full Changelog: v0.3.2...v0.3.3

v0.3.2

Choose a tag to compare

@github-actions github-actions released this 20 Sep 04:02
faee0c1

Features & Improvements

  • Scope & permission diagnostics: 403 Forbidden errors across all resource commands now name exact denied action and list precise API scopes required (including alternative/conjunction requirements). Output preserves upstream request ID/code, highlights role/project/license caveats, and points directly to n8n discover. Supported across workflows, credentials, executions, tags, data tables, projects, users, roles, variables, community/enterprise packages, evaluations, and SSO/policy commands.

What's Changed

Full Changelog: v0.3.1...v0.3.2

v0.3.1

Choose a tag to compare

@github-actions github-actions released this 19 Sep 20:08
dcf1151

Bug Fixes

  • config: treat Windows access-denied error as lock contention during concurrent config writes so it retries instead of failing.

What's Changed

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 19 Sep 17:49
0dd2a1e

Highlights

  • n8n workflow copy — copy one saved workflow definition between two saved contexts (e.g. staging to production, or production back to staging for rollback). Source is only ever read; every write lands on target. Match source by --from-id or --name, target by --to-id or name with create-when-absent. Target is fully replaced unless --create-only / --update-only given; existing target stays draft unless --publish passed. Tags, credentials, folders, sharing do not transfer (per-instance IDs). Pinned sample data + runtime static data excluded unless --include-pinned-data / --include-static-data. Refuses same-instance copy + archived workflows. Text = summary, --output json = versioned result. Verify afterwards with n8n workflow diff.

What's Changed

Full Changelog: v0.2.0...v0.3.0