Repository navigation
Releases
Releases · SomeoneWithOptions/n8n-cli
v0.6.0
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
What's Changed
Features
- feat(ldap): support optional
linkexistingaccountsbyemailsetting by @SomeoneWithOptions in #39 - feat(dependencies): add workflow, credential and data-table dependency lookups by @SomeoneWithOptions in #43
- feat(promotion): add promotion environments by @SomeoneWithOptions in #44
- feat(promotion): add environment apply/promote and n8n 2.46 project sync fields by @SomeoneWithOptions in #45
Fixes
- fix: workflow, execution and community-package spec drift (n8n 2.46.4) by @SomeoneWithOptions in #41
- fix(package): support n8n 2.46.4 import changes by @SomeoneWithOptions in #42
Full Changelog: v0.4.0...v0.5.0
v0.4.0
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 applyno longer reports a blocked apply as success. The result now follows the serverstatus(applied/blocked/source-changed);blockedandsource-changedexit non-zero and print the preflight details. Previously it printedApplied:and exited 0 even when nothing was written.community-package install|update --verifyremoved 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 --offsetdeprecated. The server ignores it; use--cursor. Flag is hidden and ignored.node-policy setwarnings carrykind(shadowed|notLoaded) in JSON and text output;shadowedByRuleIdis omitted when empty.package exportbody field rename.--dependency-policy/--version-policyreplace--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.CreateProjecttakesCreateProjectRequest;n8n.DataTableCreateColumnTypesremoved.
Features
--idempotency-key KEY|autoonworkflow create,execution stop|stop-many|retry,data-table row insert|upsert,package import|import-selection,promotion apply|promote|apply-continueandpromotion project apply|promote|apply-continue. Sends theIdempotency-Keyheader so a retry after a timeout returns the first result instead of running twice.autogenerates 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-policycommand 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 …andnode-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-continueandpromotion 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 providercommands. user delete --transfer-to-project PROJECT_ID: move the user's workflows and credentials instead of deleting them.project creategains--id,--description,--icon TYPE:VALUE,--icon-color,--telemetry-tag KEY=VALUE; reads keep icon, description, telemetry tags, creator and timestamps.credential createinput acceptsdescriptionand a customid;credential updateacceptsdescription(null/blank clears). Reads keepdescriptionandusageScope.workflow list --include-parent-folder: adds a FOLDER column andparentFolderin JSON.saml set:--email-verified-requiredand--email-verified-attributefor the now-requiredemailVerifiedRequired/mapping.emailVerifiedfields;get | set --input -round-trips.otel set:--emit-workflow-start-span/--emit-node-start-span; previously everysetsilently turned both off.community-package installaccepts 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 listfailed to decode numericexecutionId; now accepts numbers and numeric strings.workflow create|update|copy:descriptionis kept instead of being dropped;parentFolderId: nullis sent to move to project root; read-only"DEFAULT"settings and nodecreatedAt/updatedAtare stripped and reported on stderr; nullsettingsis sent as{}.workflow update|publish|copy403/409 errors name the saved draft or blocking review instead of guessing.data-table:jsoncolumn type refused locally with a hint;--sort-byand column names validated before the request.variable: key, value and project ID limits validated locally; update help no longer claims omitting--project-idmoves to global.folder: name and ID length limits validated;--parent-folder-id 0documented as "move to project root".node-policy set --inputno longer fails onwarningsfrom a previoussetor raw API output.community-package updatewithout--versionsends 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 nowboth.
What's Changed
- fix(cli): report license denials separately from missing scopes by @SomeoneWithOptions in #26
- fix(package): align export/import with upstream spec 1.1.1 by @SomeoneWithOptions in #27
- fix(promotion): report blocked applies and accept gitlab providers by @SomeoneWithOptions in #28
- fix(saml,otel): send new email-verification and start-span settings by @SomeoneWithOptions in #29
- fix(community-package,user): accept scoped names, drop verify, add delete transfer by @SomeoneWithOptions in #30
- feat(node-policy): add notloaded warnings and shared document scope docs by @SomeoneWithOptions in #31
- fix: core resource spec drift (evaluation, workflow, credential, data-table, project, variable, folder) by @SomeoneWithOptions in #33
- feat(package): add import-selection command for project packages by @SomeoneWithOptions in #35
- feat(promotion): add selected workflow sync and repository discovery by @SomeoneWithOptions in #36
- feat(policy): add reusable documents and scope attachments by @SomeoneWithOptions in #37
- feat(idempotency): add idempotency-key support to mutating commands by @SomeoneWithOptions in #38
Full Changelog: v0.3.6...v0.4.0
v0.3.6
Features & Improvements
--quietand--brieffor list commands:n8n workflow list,tag list,credential list,project list, andexecution listget two text views for scripts. Neither prints a header.--quietprints one ID per line.--briefprints 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
--allreporting: every list command that supports--allnow says whether the walk finished or stopped at the 10,000-item cap. With--output json, the result has a newcollectionobject (truncated,limit) so a script can tell a complete list from a capped one without reading stderr.nextCursoris set only when resuming from it can't skip an item, andn8n folder listaddsnextSkipfor offset resume. At the cap, stderr prints a warning with resume steps, also in--quiet/--briefmode.n8n folder list --allkeepscountas 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
- feat(cli): add --quiet and --brief to workflow list by @SomeoneWithOptions in #21
- feat(cli): add --quiet and --brief script views to list commands by @SomeoneWithOptions in #22
- feat(pagination): improve --all flag reporting by @SomeoneWithOptions in #23
Full Changelog: v0.3.5...v0.3.6
v0.3.5
Features & Improvements
- Multiple
--statusvalues forn8n execution list:--statusnow 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.--cursorstill requires a single status. With--include-data, it fetches up to--limitdetailed rows per status and shows--limitof them.
What's Changed
- feat(execution): allow multiple statuses for list command by @SomeoneWithOptions in #20
Full Changelog: v0.3.4...v0.3.5
v0.3.4
Features & Improvements
N8N_CONTEXTenvironment selection: context resolution precedence is now--context, thenN8N_CONTEXT(empty string counts as unset), then saved current context. Resource commands,n8n auth status, andn8n auth logoutreject unknown selections without persisting environment choice;n8n auth loginresolves name identically (fallbackdefault) 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
- feat: N8N_CONTEXT selection + config context rename by @SomeoneWithOptions in #19
Full Changelog: v0.3.3...v0.3.4
v0.3.3
Features & Improvements
n8n auth login --skip-verify: save a credential without the remote/discoververification 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 withn8n auth statusor verify a real command (e.g.n8n user list --limit 1).
What's Changed
- feat(cli): add --skip-verify to auth login by @SomeoneWithOptions in #18
Full Changelog: v0.3.2...v0.3.3
v0.3.2
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
- feat: improve error handling and scope reporting by @SomeoneWithOptions in #16
Full Changelog: v0.3.1...v0.3.2
v0.3.1
Bug Fixes
config: treat Windows access-denied error as lock contention during concurrent config writes so it retries instead of failing.
What's Changed
- fix(config): treat Windows access-denied as lock contention by @SomeoneWithOptions in #13
Full Changelog: v0.3.0...v0.3.1
v0.3.0
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-idor--name, target by--to-idor name with create-when-absent. Target is fully replaced unless--create-only/--update-onlygiven; existing target stays draft unless--publishpassed. 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 withn8n workflow diff.
What's Changed
- feat(workflow): add workflow copy command by @SomeoneWithOptions in #10
Full Changelog: v0.2.0...v0.3.0