Skip to content

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 17:50
· 8 commits to main since this release
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