Repository navigation
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