Como exportar seus workflows do Pipedream antes que sejam apagados

Abra o projeto no Pipedream, selecione Settings, clique em Export Workflows e baixe o project_export-<project_id>.zip do File Store do projeto. Repita para cada projeto antes que o Pipedream apague todos os dados do Workflows até 30 de abril de 2027 (os workflows param de funcionar em 31 de março de 2027). Se o seu plano não inclui File Stores, use o GitHub Sync ou a API REST.

Este guia mostra a exportação oficial, o que ela deixa de fora, a restrição de plano que pode bloquear workspaces Free e Basic e as duas alternativas.

Opção 1: a ferramenta oficial Export Workflows

O Pipedream adicionou uma ferramenta de exportação junto com o anúncio do encerramento. Ela exporta um projeto por vez:

1. Abra o projeto no dashboard do Pipedream e selecione Settings no menu à esquerda.
2. Clique em Export Workflows, no fim do painel de configurações. O Pipedream gera o ZIP em segundo plano.
3. Quando a exportação terminar, selecione File Store no menu à esquerda do projeto e baixe o project_export-<project_id>.zip.

Cada projeto só pode ter uma exportação por vez. Para exportar de novo depois de alterar um workflow, apague o ZIP existente do File Store e clique em Export Workflows outra vez.

O que vem no ZIP

O ZIP mantém a estrutura de pastas do seu projeto:

project_export-proj_abc123.zip
├── manifest.json
├── sync-leads-to-sheets-p_abc123.json
└── Marketing/
    └── weekly-digest-p_def456.json

O manifest.json (schema project-export/2026.01) lista todos os workflows do projeto, inclusive os que não foram exportados, então nada some sem deixar registro. Cada entrada tem hashid, name, path, status e uma lista warnings. Um aviso típico diz: "step send_message: secret prop api_key was omitted from the export and must be re-entered after import." Ou seja: a prop secreta api_key da etapa send_message foi omitida da exportação e precisa ser digitada de novo depois da importação.

Status	Significado
exported	O arquivo do workflow está no ZIP, no caminho indicado em path.
skipped_never_deployed	O workflow nunca passou por deploy, então não havia nada para exportar.
skipped_export_limit	A exportação atingiu o limite antes de chegar a este workflow.

Cada arquivo de workflow (schema workflow.json/2026.01) traz a última versão implantada:

• name, description, inactive e settings.
• triggers, cada um com um tipo (source, http, timer, email ou form). As configurações dos triggers HTTP, de agendamento e de formulário são exportadas por completo. As fontes de eventos (event sources) incluem as props configuradas.
• steps em ordem, com o nome e o tipo de cada etapa, o código (nas etapas de código) ou a chave e a versão do componente (nas ações), e as props configuradas.
• deployments, que guardam as etapas dentro das ramificações if/else e switch.

Alterações sem deploy não entram na exportação. Se você alterou um workflow no editor sem fazer deploy, faça o deploy antes de exportar.

O que a exportação oculta

O Pipedream substitui qualquer valor que seja, ou possa ser, uma credencial:

Tipo de prop	O que a exportação contém
Props secretas, incluindo props secret: true em etapas de código	<redacted>
Props de app (contas conectadas)	Só o authProvisionId. Os tokens são removidos.
Props de requisição HTTP	A configuração da requisição. O objeto auth vira <redacted>.
Props sem declaração	<redacted>, porque o Pipedream não consegue saber se guardam uma credencial
Props de sistema, como $.service.db e $.interface.http	<redacted>
Todas as outras props	O valor como foi configurado

Os nomes das props são sempre mantidos, então dá para ver do que cada etapa precisa.

Limites

Uma exportação inclui no máximo 500 workflows ou 256 MB de conteúdo de workflows, o que vier primeiro. Se um projeto passar disso, truncated fica true no manifest.json e os workflows restantes recebem skipped_export_limit. A solução do Pipedream é mover alguns workflows para outro projeto e exportar cada projeto separadamente.

A pegadinha do File Store nos planos Free e Basic

A documentação de exportação diz: "Export writes the archive to the project's File Store, so your plan must include File Stores" (a exportação grava o ZIP no File Store do projeto, então o seu plano precisa incluir File Stores). O FAQ de File Stores do Pipedream diz: "At this time File Stores are only available to Advanced plan and above subscribed workspaces" (no momento, os File Stores só estão disponíveis para workspaces com assinatura do plano Advanced ou superior).

Lidas juntas, as duas frases significam que workspaces nos planos Free ou Basic talvez não consigam usar a exportação oficial. Fazer upgrade também não é uma opção, porque o Pipedream parou de aceitar novas assinaturas do Workflows em 30 de setembro de 2026. Se o botão não funcionar para você, use uma das duas alternativas abaixo.

Se você está no Advanced ou em um plano superior, exporte antes de fazer downgrade ou cancelar. A documentação de preços do Pipedream diz que um downgrade desativa os recursos que ficam fora do novo plano.

Opção 2: GitHub Sync

Quando o GitHub Sync está ativado em um projeto, o Pipedream serializa cada workflow em YAML e faz commit dele em um repositório do GitHub. Se os seus projetos já usam o recurso, esse repositório já é uma exportação.

Um workflow em um repositório sincronizado fica assim (exemplo do repositório público do Pipedream):

schema: workflow/2022.04
name: Daily Schedule Text
steps:
- namespace: calculate_end_of_day
  uses: "./calculate_end_of_day/entry.js"
  props:
    timestamp: "{{steps.trigger.event.timezone_utc.iso8601.timestamp}}"
- namespace: send_sms
  uses: twilio-send-sms@0.1.3
  props:
    twilio:
      authProvisionId: apn_86hM9K9
    body: "{{steps.generate_text.$return_value}}"

As etapas de código ficam em arquivos entry.js separados, ao lado do workflow.yaml. O que você precisa saber:

• O Pipedream não publicou uma definição desse formato YAML. A resposta no FAQ é "Not yet, please stay tuned!" (ainda não, fiquem ligados).
• A documentação não diz quais planos incluem o GitHub Sync. Ela descreve como ativá-lo ao criar um projeto e como mover workflows existentes para um projeto.
• Workflows legados (v1) não são suportados em projetos.
• Faça merge em production antes de confiar no repositório. Branches podem conter alterações que nunca passaram por deploy.

Opção 3: a API REST do Pipedream

O Pipedream documenta um endpoint que retorna a definição de um workflow, o Get a Workflow's Details:

curl "https://api.pipedream.com/v1/workflows/p_abc123?org_id=o_abc123" \
  -H "Authorization: Bearer $PIPEDREAM_API_KEY"

A resposta inclui os triggers e as etapas do workflow, com o namespace, o runtime, a configuração do componente e as props de cada etapa. Você precisa de:

• Uma API key, que você encontra nas configurações da sua conta do Pipedream. Mantenha-a na sua própria máquina.
• O ID do workspace (o_...) para o parâmetro org_id.
• Os IDs dos workflows (p_...). Eles aparecem na URL de cada workflow.

A parte chata é conseguir a lista de IDs. Não existe endpoint para listar todos os workflows: o pedido de funcionalidade PipedreamHQ/pipedream#16720 continua aberto. O projeto open source pipedream-toolkit contorna isso lendo os IDs pela opção Export tree as text da interface do Pipedream e chamando o endpoint para cada um.

Um script mínimo, supondo um ID de workflow por linha em workflow_ids.txt:

ORG_ID=o_abc123
mkdir -p pd-workflows
while read -r id; do
  curl -s "https://api.pipedream.com/v1/workflows/${id}?org_id=${ORG_ID}" \
    -H "Authorization: Bearer ${PIPEDREAM_API_KEY}" > "pd-workflows/${id}.json"
done < workflow_ids.txt

A referência da API não menciona restrições de plano, mas teste com um workflow antes de automatizar o resto.

Baixe tudo com a CLI do Workflow Exit

A CLI do Workflow Exit faz esse download para você. Ela roda na sua máquina (Node.js 18 ou mais recente), então a sua API key só é enviada para api.pipedream.com:

# PowerShell: $env:PIPEDREAM_API_KEY="..."
export PIPEDREAM_API_KEY=...
node workflow-exit.mjs pull --org o_abc123
node workflow-exit.mjs report pipedream-workflows

• Sem --id nem --ids, ela pede ao Pipedream a lista de workflows do workspace. Se a sua API key não tiver acesso a essa lista, passe os IDs: --ids tree.txt aceita qualquer texto que contenha IDs p_..., como o arquivo gerado pelo Export tree as text.
• As etapas dentro de blocos if/else, switch e outros blocos com ramificações ficam em pipelines separados. A CLI também busca essas etapas e as salva junto com o workflow.
• report gera o REPORT.md localmente. Você também pode carregar a pasta pipedream-workflows na página do relatório de migração; a análise é feita no seu navegador.

O checksum SHA-256 do arquivo está publicado em /cli/workflow-exit.mjs.sha256. O código dos comandos report e pull está no GitHub com licença MIT.

Qual método de exportação usar

Método	Quem pode usar	Formato	Principais lacunas
Export Workflows (ZIP)	Planos que incluem File Stores (Advanced e superiores, segundo o FAQ do Pipedream)	manifest.json mais um JSON por workflow	Segredos, contas, variáveis de ambiente, dados
GitHub Sync	Projetos com GitHub Sync ativado	workflow.yaml mais um entry.js por etapa de código	Sem schema publicado, só projetos sincronizados
API REST	Qualquer pessoa com uma API key e os IDs dos workflows	Um JSON por workflow	Sem endpoint de listagem, uma requisição por workflow

Nenhum dos três exporta valores secretos, tokens OAuth, variáveis de ambiente, registros de data stores, arquivos do File Store nem o histórico de eventos.

Salve o que nenhuma exportação inclui

Faça isso enquanto os seus workflows ainda estão rodando, antes de 31 de março de 2027:

• Variáveis de ambiente: liste-as nas Settings do workspace, em Environment Variables, e na página Variables de cada projeto. A documentação de variáveis de ambiente do Pipedream diz que um valor secreto "nunca é exibido na interface" ("is never exposed in the UI"), então recupere esses valores na origem: no dashboard do provedor ou no seu gerenciador de senhas.
• Props secretas: use os warnings do manifest.json como checklist do que você vai precisar digitar de novo.
• Data stores: veja os registros no dashboard de Data Stores ou adapte a etapa de código de exemplo da documentação de data stores do Pipedream. Essa etapa envia os registros para um serviço externo em lotes. Rode-a primeiro com a exclusão de chaves desativada.
• Arquivos do File Store: baixe-os do File Store de cada projeto.
• Eventos de exemplo: copie alguns payloads reais de cada workflow no inspetor de eventos. Você vai precisar deles para os testes, e o histórico de eventos não é exportado.
• Componentes privados: guarde a sua própria cópia do código-fonte. Só a chave do componente é exportada.

Depois de exportar

Arraste o ZIP, um repositório do GitHub Sync ou os arquivos JSON da API REST para o relatório de migração gratuito. O relatório roda inteiramente no seu navegador e lista, por workflow, os triggers e seus equivalentes no n8n, as ações com e sem mapeamento automático, os pacotes npm e se o n8n Cloud consegue carregá-los, os segredos ocultados, as variáveis de ambiente, as contas conectadas a recriar e os dados a salvar antes de 30 de abril de 2027.

Depois, siga o guia de migração do Pipedream para o n8n ou leia o cronograma do encerramento se você ainda está planejando. Quando estiver pronto para converter, os preços começam em US$ 49 para até 25 workflows, e o primeiro workflow é grátis. Rode o relatório primeiro: ele não custa nada e mostra exatamente o que a sua exportação contém.