Import & Export

AutoFlow supports exporting workflows as self-contained portable JSON envelopes and importing workflows from external files.

Export

Export any catalog or custom workflow to a portable JSON file:

python -m autoflow --export classification

This produces a file with a wrapper envelope:

{
  "export_format": "autoflow_workflow_v1",
  "exported_at": "2025-01-15T10:30:00Z",
  "source_slug": "classification",
  "workflow": {
    "nodes": [...],
    "edges": [...],
    "metadata": {...}
  }
}

The envelope includes format versioning and provenance so the workflow can be shared and re-imported reliably.

Import

Import a workflow from a portable JSON file:

python -m autoflow --import-workflow /path/to/exported.json

The imported workflow is saved to workflows/custom_workflows/ and becomes available in the catalog alongside built-in templates.

Import validates:

1. The envelope format and version
2. The contained workflow against the Agent Builder schema
3. Structural rules (node IDs, edges, orphans, variables)

Sharing Workflows

The export/import cycle makes it straightforward to share workflows between teams:

1. Author develops and tests a workflow using the catalog and customization tools
2. Author exports: python -m autoflow --export my_workflow
3. Recipient imports: python -m autoflow --import-workflow shared_workflow.json
4. Recipient can further customize: python -m autoflow --fork my_workflow --fork-as team_version

Programmatic Access

from autoflow.catalog.customizer import WorkflowCustomizer

customizer = WorkflowCustomizer()

# Export
customizer.export_workflow("classification", "/tmp/classification.json")

# Import
customizer.import_workflow("/tmp/classification.json")