Automations

Automations bring multi-step workflow capabilities to Chaos Cypher, enabling you to build automated knowledge extraction and processing pipelines.

Workflows

Managing Workflows

Web UI

Navigate to Workflows in the sidebar to create, view, edit, and delete workflows.

CLI

# List all workflows
chaoscypher graph workflow list

# View details of a specific workflow
chaoscypher graph workflow get entity-extraction

# Verbose view with step counts
chaoscypher graph workflow list --verbose

API

GET    /api/v1/workflows              # List workflows
POST   /api/v1/workflows              # Create workflow
GET    /api/v1/workflows/{id}         # Get workflow
PATCH  /api/v1/workflows/{id}         # Update workflow
DELETE /api/v1/workflows/{id}         # Delete workflow

See the Workflows API Reference for request/response details and examples.

Workflow Steps

Each workflow contains ordered steps that execute sequentially. Steps reference tool plugins for execution logic.

Web UI

Use the visual workflow builder to add, configure, reorder, and connect steps using drag-and-drop.

API

GET    /api/v1/workflows/{id}/steps              # List steps
POST   /api/v1/workflows/{id}/steps              # Create step
GET    /api/v1/workflows/{id}/steps/{step_id}    # Get step
PATCH  /api/v1/workflows/{id}/steps/{step_id}    # Update step
DELETE /api/v1/workflows/{id}/steps/{step_id}    # Delete step
PUT    /api/v1/workflows/{id}/steps/reorder      # Reorder steps

See the Workflows API Reference — Steps for request/response details.

Available tool types for steps include AI tools (prompts, JSON extraction, embeddings, vector search), data tools (extract, merge), logic tools (conditional, loop), HTTP tools, and template tools. See Tool Plugins for the full list.

Workflow Execution

Web UI

Click Run on a workflow to execute it. Progress is displayed in real-time with step-by-step status updates.

API

POST   /api/v1/workflows/{id}/executions                    # Execute workflow (returns 202 + execution_id)
GET    /api/v1/workflows/{id}/executions                    # List execution history
GET    /api/v1/workflows/{id}/executions/{eid}              # Get execution details
POST   /api/v1/workflows/{id}/executions/{eid}/cancel       # Cancel execution
GET    /api/v1/workflows/{id}/stats                         # Execution statistics

See the Workflows API Reference — Executions for request/response details.

Import/Export

Share workflows between databases or back them up:

Web UI

Use the export/import buttons on the Workflows page to save and load workflow definitions as JSON files.

CLI

# Export as part of a CCX package
chaoscypher graph package export --output my-workflows.ccx

# Import from a CCX package
chaoscypher graph package load my-workflows.ccx

API

GET    /api/v1/workflows/{id}/export    # Export workflow to JSON
POST   /api/v1/workflows/import         # Import workflow from JSON

See the Workflows API Reference — Import/Export for request/response details.

Triggers

Triggers connect events to workflow execution:

Trigger	Fires when
Source Upload	A new source is uploaded
Extraction Complete	Entity extraction finishes
Schedule	On a cron schedule
Manual	User-initiated

Web UI

Configure triggers from the workflow detail view. Select the trigger type and configure its conditions.

API

GET    /api/v1/workflows/{id}/triggers  # List triggers for workflow

See the Triggers API Reference for full CRUD operations.

Visual Workflow Builder

The workflow builder provides a visual drag-and-drop canvas for designing workflows. Access it from the Workflows page in the web UI.

The builder supports:

• Drag-and-drop step placement from the tool palette
• Visual connections between steps
• Conditional branching with condition builder
• Step configuration via properties panel
• Test execution with live progress
• Execution history panel