Cómo exportar tus workflows de Pipedream antes de que se borren

Abre el proyecto en Pipedream, selecciona Settings, haz clic en Export Workflows y descarga project_export-<project_id>.zip desde el File Store del proyecto. Repite el proceso con cada proyecto antes de que Pipedream borre todos los datos de Workflows a más tardar el 30 de abril de 2027 (los workflows dejan de funcionar el 31 de marzo de 2027). Si tu plan no incluye File Stores, usa GitHub Sync o la API REST.

Esta guía explica la exportación oficial, lo que deja fuera, la restricción de plan que puede bloquear a los workspaces Free y Basic, y las dos alternativas.

Opción 1: la herramienta oficial Export Workflows

Pipedream agregó una herramienta de exportación junto con el anuncio del cierre. Funciona proyecto por proyecto:

1. Abre el proyecto en el dashboard de Pipedream y selecciona Settings en el menú lateral izquierdo.
2. Haz clic en Export Workflows, al final del panel de configuración. Pipedream genera el ZIP en segundo plano.
3. Cuando termine, selecciona File Store en el menú lateral izquierdo del proyecto y descarga project_export-<project_id>.zip.

Cada proyecto puede tener una sola exportación a la vez. Para volver a exportar después de cambiar un workflow, borra el ZIP existente del File Store y vuelve a hacer clic en Export Workflows.

Qué contiene el ZIP

El ZIP conserva la estructura de carpetas de tu proyecto:

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

manifest.json (esquema project-export/2026.01) lista todos los workflows del proyecto, incluidos los que no se exportaron, así que nada desaparece sin dejar registro. Cada entrada tiene hashid, name, path, status y una lista warnings. Una advertencia típica dice: "step send_message: secret prop api_key was omitted from the export and must be re-entered after import". Es decir: la prop secreta api_key del paso send_message se omitió en la exportación y hay que volver a ingresarla después de importar.

Status	Significado
exported	El archivo del workflow está en el ZIP, en la ruta indicada en path.
skipped_never_deployed	El workflow nunca se desplegó, así que no había nada que exportar.
skipped_export_limit	La exportación alcanzó su límite antes de llegar a este workflow.

Cada archivo de workflow (esquema workflow.json/2026.01) contiene la última versión desplegada:

• name, description, inactive y settings.
• triggers, cada uno con un tipo (source, http, timer, email o form). La configuración de los triggers HTTP, programados y de formulario se exporta completa. Las fuentes de eventos (event sources) incluyen sus props configuradas.
• steps en orden, con el nombre y el tipo de cada paso, el código (en los pasos de código) o la clave y la versión del componente (en las acciones), y las props configuradas.
• deployments, que contienen los pasos dentro de las ramas if/else y switch.

Los cambios sin desplegar no se incluyen. Si modificaste un workflow en el editor sin desplegarlo, despliégalo antes de exportar.

Qué oculta la exportación

Pipedream reemplaza cualquier valor que sea, o pueda ser, una credencial:

Tipo de prop	Qué contiene la exportación
Props secretas, incluidas las props secret: true de los pasos de código	<redacted>
Props de app (cuentas conectadas)	Solo el authProvisionId. Los tokens se eliminan.
Props de petición HTTP	La configuración de la petición. El objeto auth aparece como <redacted>.
Props sin declaración	<redacted>, porque Pipedream no puede saber si contienen una credencial
Props de sistema como $.service.db y $.interface.http	<redacted>
Todas las demás props	El valor tal como se configuró

Los nombres de las props siempre se conservan, así que puedes ver qué necesita cada paso.

Límites

Una exportación incluye como máximo 500 workflows o 256 MB de contenido de workflows, lo que ocurra primero. Si un proyecto supera el límite, truncated vale true en manifest.json y los workflows restantes quedan como skipped_export_limit. La solución que propone Pipedream es mover algunos workflows a otro proyecto y exportar cada proyecto por separado.

El problema del File Store en los planes Free y Basic

La documentación de exportación dice: "Export writes the archive to the project's File Store, so your plan must include File Stores" (la exportación guarda el ZIP en el File Store del proyecto, así que tu plan debe incluir File Stores). Las preguntas frecuentes sobre File Stores de Pipedream dicen: "At this time File Stores are only available to Advanced plan and above subscribed workspaces" (por ahora, los File Stores solo están disponibles para los workspaces suscritos al plan Advanced o superior).

Leídas en conjunto, estas dos frases significan que los workspaces con plan Free o Basic quizá no puedan usar la exportación oficial. Subir de plan tampoco es posible, porque Pipedream dejó de aceptar nuevas suscripciones a Workflows el 30 de septiembre de 2026. Si el botón no te funciona, usa una de las dos alternativas que siguen.

Si tienes el plan Advanced o uno superior, exporta antes de bajar de plan o cancelar. La documentación de precios de Pipedream dice que bajar de plan desactiva las funciones que quedan fuera del nuevo plan.

Opción 2: GitHub Sync

Cuando GitHub Sync está activado en un proyecto, Pipedream serializa cada workflow a YAML y lo guarda con un commit en un repositorio de GitHub. Si tus proyectos ya lo usan, ese repositorio ya es una exportación.

Así se ve un workflow en un repositorio sincronizado (tomado del repositorio público de ejemplo de 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}}"

Los pasos de código están en archivos entry.js separados, junto a workflow.yaml. Lo que conviene saber:

• Pipedream no ha publicado una definición de este formato YAML. Su respuesta en las preguntas frecuentes es "Not yet, please stay tuned!" (todavía no, estén atentos).
• La documentación no dice qué planes incluyen GitHub Sync. Explica cómo activarlo al crear un proyecto y cómo mover workflows existentes a un proyecto.
• Los workflows legacy (v1) no son compatibles con los proyectos.
• Haz merge a production antes de confiar en el repositorio. Las ramas pueden contener cambios que nunca se desplegaron.

Opción 3: la API REST de Pipedream

Pipedream documenta un endpoint que devuelve la definición de un workflow, Get a Workflow's Details:

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

La respuesta incluye los triggers y los pasos del workflow, con el namespace, el runtime, la configuración del componente y las props de cada paso. Necesitas:

• Una API key de la configuración de tu cuenta de Pipedream. Mantenla solo en tu propia máquina.
• El ID del workspace (o_...) para el parámetro org_id.
• Los IDs de los workflows (p_...). Aparecen en la URL de cada workflow.

Lo incómodo es conseguir la lista de IDs. No hay ningún endpoint que liste todos los workflows: la solicitud de funcionalidad PipedreamHQ/pipedream#16720 sigue abierta. El proyecto open source pipedream-toolkit sortea el problema leyendo los IDs desde la opción Export tree as text de la interfaz de Pipedream y llamando luego al endpoint para cada uno.

Un script mínimo, suponiendo que workflow_ids.txt tiene un ID de workflow por línea:

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

La referencia de la API no menciona restricciones por plan, pero prueba el endpoint con un workflow antes de automatizar el resto.

Descarga todo con la CLI de Workflow Exit

La CLI de Workflow Exit hace esta descarga por ti. Se ejecuta en tu máquina (Node.js 18 o superior), así que tu API key solo se envía a 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

• Sin --id ni --ids, le pide a Pipedream la lista de workflows del workspace. Si tu API key no tiene acceso a esa lista, pasa los IDs: --ids tree.txt acepta cualquier texto que contenga IDs p_..., como el archivo que genera Export tree as text.
• Los pasos dentro de bloques if/else, switch y otros bloques con ramas están en pipelines separados. La CLI también los descarga y los guarda con su workflow.
• report genera REPORT.md en tu máquina. También puedes cargar la carpeta pipedream-workflows en la página del informe de migración; se analiza en tu navegador.

El checksum SHA-256 del archivo está publicado en /cli/workflow-exit.mjs.sha256. El código de los comandos report y pull está en GitHub con licencia MIT.

Qué método de exportación usar

Método	Quién puede usarlo	Formato	Principales carencias
Export Workflows (ZIP)	Planes que incluyen File Stores (Advanced y superiores, según las preguntas frecuentes de Pipedream)	manifest.json más un JSON por workflow	Secretos, cuentas, variables de entorno, datos
GitHub Sync	Proyectos con GitHub Sync activado	workflow.yaml más un entry.js por paso de código	Sin esquema publicado, solo proyectos sincronizados
API REST	Cualquiera con una API key y los IDs de los workflows	Un JSON por workflow	Sin endpoint para listar, una petición por workflow

Ninguno de los tres exporta valores secretos, tokens OAuth, variables de entorno, registros de data stores, archivos del File Store ni el historial de eventos.

Guarda lo que ninguna exportación incluye

Hazlo mientras tus workflows todavía funcionan, antes del 31 de marzo de 2027:

• Variables de entorno: lístalas desde Settings, Environment Variables del workspace, y desde la página Variables de cada proyecto. La documentación de variables de entorno de Pipedream dice que un valor secreto "nunca se muestra en la interfaz" ("is never exposed in the UI"), así que recupera esos valores de su origen: el dashboard del proveedor o tu gestor de contraseñas.
• Props secretas: usa los warnings de manifest.json como checklist de lo que tendrás que volver a ingresar.
• Data stores: consulta los registros en el dashboard de Data Stores, o adapta el paso de código de ejemplo de la documentación de data stores de Pipedream, que envía los registros a un servicio externo por lotes. Ejecútalo primero con el borrado de claves desactivado.
• Archivos del File Store: descárgalos desde el File Store de cada proyecto.
• Eventos de muestra: copia algunos payloads reales de cada workflow desde el inspector de eventos. Los vas a necesitar para las pruebas, y el historial de eventos no se exporta.
• Componentes privados: guarda tu propia copia del código fuente. Solo se exporta la clave del componente.

Después de exportar

Arrastra el ZIP, un repositorio de GitHub Sync o los archivos JSON de la API REST al informe de migración gratuito. El informe se ejecuta por completo en tu navegador y lista, por workflow, los triggers y sus equivalentes en n8n, las acciones con y sin mapeo automático, los paquetes npm y si n8n Cloud puede cargarlos, los secretos ocultos, las variables de entorno, las cuentas conectadas que hay que recrear y los datos que hay que guardar antes del 30 de abril de 2027.

Luego sigue la guía para migrar de Pipedream a n8n, o lee el calendario del cierre si todavía estás planificando. Cuando estés listo para convertir, los precios empiezan en US$49 (hasta 25 workflows), y el primer workflow es gratis. Ejecuta primero el informe: no cuesta nada y muestra exactamente qué contiene tu exportación.