Pular para o conteúdo
Breaking change

n8n 3.1.0

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
5 de 120
Nesta página

Resumo

O n8n 3.1.0 reúne o histórico de versões dos agentes e a construção de Apps também presentes na 2.47.0, mas acrescenta mudanças próprias da linha 3. A remoção das versões 1 e 1.1 do Edit Image exige revisar workflows que utilizam esses Nodes. A publicação continua marcada como pré-release.

Novidades

  • n8n 3.1.0 — Publicação de agentes: versões salvas podem ser publicadas separadamente dos rascunhos, com histórico e timeline de publicação na interface. O MCP (Model Context Protocol) permite consultar os logs das sessões.
  • n8n 3.1.0 — Apps: o Assistant incorpora a construção de Apps com prévia, detalhes e publicação pela interface.
  • n8n 3.1.0 — Integrações: o Postgres Node aceita certificados personalizados. Os Trigger Nodes do Mailchimp e do Venafi TLS Protect Cloud recebem verificação de assinatura de webhook.

Melhorias

  • n8n 3.1.0 — Conhecimento dos agentes: o limite de upload aumenta para 25 MB. A recuperação de memória episódica utiliza armazenamento binário para os embeddings e reduz as leituras por pesquisa.
  • n8n 3.1.0 — Migração: o relatório detalha os Nodes removidos e o Edit Image. A varredura utiliza paginação por chave e a tabela de resultados carrega uma página por vez.
  • n8n 3.1.0 — Nodes comunitários: a API de Nodes utiliza a versão 3 e os pacotes comunitários recebem compatibilidade com supportedNodesApiVersion v3.

Correções

  • n8n 3.1.0 — Armazenamento binário: a inicialização verifica configurações incorretas do modo S3 e normaliza a detecção de modos removidos.
  • n8n 3.1.0 — Requisições externas: a proteção de saída amplia as faixas de IP recusadas por padrão. O uso de proxies pelo Assistant também abrange consultas e alternativas de modelo.
  • n8n 3.1.0 — Execução: solicitações de parada de outro processo alcançam o worker correto. Em paginações longas, a associação entre itens é preservada. As expressões também mantêm propriedades próprias __proto__ e campos de objetos Error.
  • n8n 3.1.0 — Acesso: rotas que consultam execuções exigem execution:read. As consultas de pastas respeitam o projeto e a telemetria do chat de teste deixa de transmitir as instruções do agente.

Breaking changes

  • n8n 3.1.0 — Edit Image: as versões 1 e 1.1 do Node são removidas. Workflows que utilizam essas versões precisam substituir o Node por uma versão disponível e conferir o processamento das imagens com o relatório de migração.

Ponto de Atenção

O Chat Hub fica desativado por padrão. As notas revertem a remoção do modo Run once for each item do Execute Sub-workflow Node e da política Any workflow, portanto esses itens não devem ser anunciados como removidos nesta publicação.

Teste sugerido: abra o relatório de migração numa cópia da instância, localize os usos antigos do Edit Image e execute os workflows após a substituição. Confira a inicialização com o armazenamento binário configurado e teste as requisições externas necessárias às automações.

Notas da versão

O n8n 3.1.0 foi publicado em 03/11/2026, às 08h33 UTC, como pré-release. O número major não transforma essa tag em versão estável.

Versões anteriores

    • n8n 2.47.0

      O n8n 2.47.0 acrescenta histórico de versões dos agentes e permite publicar uma versão gravada separadamente do rascunho.

      Stable
    • n8n 2.46.4

      O n8n 2.46.4 corrige a avaliação de expressões e a associação de itens em paginações longas.

      Stable
    • n8n 2.46.3

      O n8n 2.46.3 acrescenta orientações de correção à página de detalhes dos apontamentos de migração.

      Stable
    • n8n 2.45.7

      O n8n 2.45.7 exige autorização de leitura nas rotas de workflow que consultam execuções.

      Stable
    • n8n 1.123.91

      O n8n 1.123.91 corrige a leitura da saída legada do Code node por expressões que referenciam outro Node.

      Stable
    • n8n 2.46.2

      O n8n 2.46.2 ajusta a distribuição dos trabalhos em fila e a permissão para ler execuções pelas rotas de um workflow.

      Stable

Versões posteriores

    • n8n 2.47.2

      O n8n 2.47.2 recebe na linha de teste a correção da instalação via npm.

      Stable
    • n8n 2.47.1

      O n8n 2.47.1 ajusta o relatório de migração na linha de pré-release.

      Stable
    • n8n 2.46.6

      O n8n 2.46.6 corrige a instalação via npm nas plataformas afetadas.

      Stable
    • n8n 2.46.5

      O n8n 2.46.5 corrige a resolução de credenciais ao carregar parâmetros dos Nodes e a leitura de chaves nomeadas em arrays nas expressões.

      Stable
Ver todas as 120 versões do n8n
Histórico de versões