Workflow Exit

Como exportar workflows do Pipedream no plano Free ou Basic

Atualizado em 13 de outubro de 2026

A ferramenta Export Workflows do Pipedream salva o ZIP no File Store do projeto, e o Pipedream só oferece File Stores nos planos Advanced e superiores. No Free ou no Basic, o botão de exportação pode não funcionar, e você não consegue fazer upgrade, porque o Pipedream parou de aceitar assinaturas do Workflows em 30 de setembro de 2026. Ainda assim, há três formas de tirar os seus workflows de lá: um repositório do GitHub Sync, se algum projeto já foi sincronizado; o endpoint GET /v1/workflows/{id} da API REST, por meio da CLI gratuita do Workflow Exit; ou copiar o código e as configurações manualmente. Termine antes que os workflows parem de funcionar em 31 de março de 2027. O Pipedream apaga todos os dados do Workflows até 30 de abril de 2027.

Tente primeiro o botão oficial. Abra o projeto, selecione Settings e clique em Export Workflows. Se o project_export-<project_id>.zip aparecer no File Store do projeto, use-o e siga o guia como exportar workflows do Pipedream. Se não aparecer, continue lendo.

Por que a exportação pode não funcionar no seu plano

Dois trechos da documentação do Pipedream se encaixam. A página de exportação diz que o ZIP é gravado no File Store do projeto, então o seu plano precisa incluir File Stores. O FAQ de File Stores diz que só os workspaces nos planos Advanced e superiores têm esse recurso.

Os dados de limites de plano que o dashboard do Pipedream carrega apontam na mesma direção: o Advanced é o plano mais baixo com File Stores e também o mais baixo com GitHub Sync. Não conseguimos testar o botão em um workspace Free ou Basic, então considere isso muito provável, mas não garantido.

Suas opções em resumo

Método Quando funciona O que você recebe O que fica faltando
Repositório do GitHub Sync Algum projeto foi sincronizado com o GitHub em algum momento Um workflow.yaml por workflow e o código-fonte de cada etapa de código Configurações dos triggers, valores secretos
API REST com a CLI Você consegue criar uma API key do Pipedream Um arquivo JSON por workflow, incluindo as etapas dentro das ramificações Não confirmada no Free nem no Basic, e o código pode não vir
Cópia manual Sempre O que você copiar Tempo, e qualquer coisa que passar despercebida

Nenhum método traz valores secretos, tokens OAuth, valores de variáveis de ambiente, registros de data stores, arquivos do File Store, histórico de eventos nem o código de componentes privados. Mais abaixo explicamos como salvar o que for possível.

Opção 1: um repositório do GitHub Sync

Se algum projeto já foi conectado ao GitHub, por exemplo quando o seu workspace estava em um plano superior, o Pipedream gravou os workflows dele em um repositório na sua conta do GitHub. Esse repositório continua lá mesmo que a sincronização não rode mais. A branch production guarda as versões implantadas. Cada workflow tem uma pasta com um workflow.yaml, e cada etapa de código tem a própria pasta com um entry.js, entry.mjs ou entry.py.

Baixe o repositório como ZIP, ou use um clone local, e arraste-o para o relatório gratuito. O YAML mantém os IDs dos triggers, mas não as configurações deles, então anote cada agendamento, URL de webhook e trigger de app na interface do Pipedream enquanto ainda dá. O guia do GitHub Sync para o n8n (em inglês) explica o formato em detalhes.

Opção 2: a API REST com a CLI do Workflow Exit

A referência da API do Pipedream documenta o GET https://api.pipedream.com/v1/workflows/{id}, que retorna os triggers e as etapas de um workflow. Você o chama com uma API key e o ID do seu workspace no parâmetro org_id. Duas coisas tornam isso lento manualmente: é preciso uma requisição por workflow, e as etapas dentro dos blocos if/else e switch ficam em pipelines separados, que exigem requisições próprias.

A CLI do Workflow Exit cuida das duas coisas. É um único arquivo que roda no seu computador com Node.js 18 ou mais recente e só envia a sua API key para api.pipedream.com.

  1. Baixe a CLI. Salve o workflow-exit.mjs. Para verificá-lo, compare-o com o checksum SHA-256 em /cli/workflow-exit.mjs.sha256. O código-fonte dos comandos report e pull está no GitHub.
  2. Crie uma API key do Pipedream nas configurações da sua conta. Você só vai usá-la no seu próprio computador.
  3. Encontre o ID do seu workspace. Ele começa com o_ e aparece nas configurações do workspace.
  4. Teste com um workflow. Copie o ID de um workflow da URL dele (começa com p_) e rode:
# macOS or Linux. In PowerShell, use: $env:PIPEDREAM_API_KEY="your_api_key"
export PIPEDREAM_API_KEY=your_api_key
node workflow-exit.mjs pull --org o_abc123 --id p_abc123
  1. Baixe o resto. Sem --id, a CLI pede ao Pipedream a lista de workflows do workspace. Essa rota de listagem não é documentada, então o pedido pode ser recusado. Se for, abra o menu ⋯ do workspace, escolha Export tree as text, salve o resultado como tree.txt e passe esse arquivo para a CLI. Qualquer texto que contenha IDs p_ funciona.
node workflow-exit.mjs pull --org o_abc123 --ids tree.txt
  1. Confira a saída. Cada workflow é salvo como pipedream-workflows/<id>.json, já com as etapas das ramificações. Os workflows que falharam aparecem listados com o status HTTP que o Pipedream retornou.
  2. Gere o relatório. node workflow-exit.mjs report pipedream-workflows gera o REPORT.md na sua máquina. Ou abra a página do relatório, clique em Choose a folder e escolha pipedream-workflows.

Há duas ressalvas. Ninguém confirmou publicamente que esse endpoint funciona no Free ou no Basic, e é por isso que o passo 4 começa com um único workflow. Além disso, a resposta de exemplo na documentação da API do Pipedream não mostra o código-fonte das etapas de código. Se os seus arquivos vierem sem ele, o relatório informa quantas etapas de código estão sem código, e você copia essas etapas manualmente, como na opção 3.

Opção 3: copie manualmente o que importa

Use esta opção para tudo o que as outras deixarem passar. Abra cada workflow no editor e salve:

  1. Cada etapa de código, em um arquivo com o nome da etapa, como format_order.js ou score_lead.py. Mantenha os comentários # pipedream add-package das etapas em Python.
  2. As configurações do trigger. No HTTP, a URL do endpoint e a autorização dele. Em um agendamento, a expressão cron ou o intervalo e o fuso horário. Em um trigger de app, o app, o trigger e as opções dele.
  3. O app de cada ação, a própria ação e os valores que você escolheu, como canais, IDs de planilhas e modelos de mensagem.
  4. As condições de cada etapa if/else, switch ou de filtro, e quais etapas ficam em cada ramificação.
  5. A conta conectada e os segredos que cada etapa usa.

Cópias manuais bastam para reconstruir um workflow no n8n, mas o relatório não consegue lê-las.

Salve o que nenhum método exporta

Faça isso enquanto os seus workflows ainda estão rodando:

  • Eventos de exemplo. No Free e no Basic, o Pipedream guarda no máximo 100 eventos ou 7 dias de histórico por workflow. Copie agora alguns payloads reais do inspetor de eventos de cada workflow. Você vai precisar deles para testar a versão no n8n, e os eventos mais antigos continuam sumindo.
  • Variáveis de ambiente. Copie os nomes nas configurações do workspace e dos projetos. O Pipedream não mostra os valores secretos de novo, então busque-os no serviço original ou no seu gerenciador de senhas.
  • Registros dos data stores. Consulte-os no dashboard de Data Stores ou envie-os para outro lugar com uma etapa de código. Veja como salvar os data stores do Pipedream (em inglês).
  • Contas. Os tokens OAuth não podem ser exportados, e o Pipedream os apaga junto com todo o resto. Liste os apps que você vai conectar de novo no n8n.

Um workspace que sempre esteve no Free ou no Basic não tem File Store, então não há arquivos do File Store para baixar.

Um plano curto

  1. Salve eventos de exemplo hoje, porque a janela de 7 dias não para de andar.
  2. Nesta semana, tente o Export Workflows. Se falhar, puxe os workflows com a CLI ou baixe o seu repositório do GitHub Sync.
  3. Gere o relatório para ver quais workflows são convertidos sozinhos e quais precisam de trabalho.
  4. Copie manualmente o que o relatório indicar que está faltando.
  5. Converta, teste e faça a virada bem antes de 31 de março de 2027, seguindo o guia de migração do Pipedream para o n8n.

O relatório de migração gratuito lê um ZIP de exportação, um repositório do GitHub Sync ou os arquivos JSON da CLI. Ele roda no seu navegador, então nada é enviado para gerá-lo, e mostra do que cada workflow precisa antes do encerramento do Pipedream.

Perguntas frequentes

Posso fazer upgrade para o Advanced só para usar a exportação?+

Não. O Pipedream parou de aceitar novas assinaturas do Workflows em 30 de setembro de 2026, então um workspace Free ou Basic não consegue mudar para um plano que inclua File Stores.

A API REST do Pipedream funciona no plano Free?+

A referência da API do Pipedream documenta o GET /v1/workflows/{id} sem mencionar limites de plano, mas ainda não vimos isso confirmado no Free ou no Basic. Baixe um único workflow primeiro para conferir antes de buscar o resto.

Onde encontro os IDs dos meus workflows do Pipedream?+

A URL de cada workflow contém o ID dele, que começa com p_. Para um workspace inteiro, use Export tree as text no menu do workspace. A CLI do Workflow Exit aceita qualquer arquivo de texto que contenha IDs p_.

A minha API key do Pipedream é enviada para o Workflow Exit?+

Não. A CLI roda no seu computador e só envia a key para api.pipedream.com. O relatório web nunca pede a key.

Preciso salvar arquivos do File Store no plano Free?+

O Pipedream só oferece File Stores nos planos Advanced e superiores, então um workspace que sempre esteve no Free ou no Basic não tem nenhum. Mesmo assim, você precisa salvar os registros dos data stores, os valores das variáveis de ambiente e alguns eventos de exemplo.