Import & Export

Voodflow workflows are fully portable. You can export any workflow to a self-contained JSON file and import it into another Voodflow installation.

Exporting a Workflow

1. Navigate to Voodflow → Workflows
2. Find the workflow you want to export
3. Click the ⋮ actions menu → Export
4. A JSON file is downloaded to your machine

The exported file contains:

• Workflow metadata (name, description, status)
• All node definitions (type, position, configuration)
• All edge connections (source handle → target handle)

Note: Credentials are not exported. Credential references are preserved as IDs, but the actual secrets remain in the source installation's encrypted store.

Export File Structure

{
    "voodflow_version": "1.0.0",
    "exported_at": "2025-03-16T10:00:00Z",
    "workflow": {
        "name": "Daily Report",
        "description": "Send daily sales report via email",
        "status": "active",
        "metadata": {}
    },
    "nodes": [
        {
            "id": "node_uuid_1",
            "type": "schedule_node",
            "label": "Every Day at 08:00",
            "config": {
                "type": "daily",
                "time": "08:00"
            },
            "position": { "x": 100, "y": 200 }
        },
        {
            "id": "node_uuid_2",
            "type": "data_model_node",
            "label": "Fetch Orders",
            "config": {
                "model": "App\\Models\\Order",
                "limit": 100,
                "filters": []
            },
            "position": { "x": 350, "y": 200 }
        }
    ],
    "edges": [
        {
            "source": "node_uuid_1",
            "source_handle": "output",
            "target": "node_uuid_2",
            "target_handle": "input"
        }
    ]
}

Importing a Workflow

1. Navigate to Voodflow → Workflows
2. Click Import Workflow (top-right button)
3. Select the JSON file from your filesystem
4. Review the preview (node count, type summary)
5. Click Import

After import:

• The workflow is created in Draft status
• Nodes that referenced credentials will show a warning; you must re-link them to credentials in the new installation
• Model references (e.g. App\Models\Order) must exist in the target application

Version Compatibility

The voodflow_version field in the export file indicates the Voodflow version that produced the export. Voodflow maintains backward compatibility within the same major version (v1.x → v1.x).

Importing a v1.x workflow into a v2.x installation may require a migration step — check the Changelog before upgrading.

Use Cases

Git-Based Workflow Management

Commit exported workflows to your repository:

mkdir workflows/
# Export from UI, then:
git add workflows/daily-report.json
git commit -m "feat: add daily sales report workflow"

Environment Promotion

Local → Staging → Production

Export from local, import into staging, test, then import into production.

Workflow Marketplace

Share workflows with the community or between internal teams as JSON files.

Backup Strategy

Schedule a periodic export of all workflows:

// In a scheduled Artisan command
\Voodflow\Voodflow\Models\Workflow::all()->each(function ($workflow) {
    $export = app(\Voodflow\Voodflow\Services\WorkflowExporter::class)->export($workflow);
    Storage::put("backups/workflows/{$workflow->id}.json", json_encode($export));
});