pulse-edit

Edit Pulse Workflow

Modify an existing workflow with PATCH-style updates.

Usage

/pulse-edit
/pulse-edit <specific change description>

Examples:

/pulse-edit change the LLM model to Claude
/pulse-edit add error handling to the API call
/pulse-edit remove the classification step
/pulse-edit connect node X to node Y

Edit Workflow Process

Step 1: Understand Current State

Always start by viewing the current workflow:

# Ensure correct app is selected
list_apps(mode="workflow")
select_app(app_id="...")

# View complete structure
view_workflow(include_details=True)

# List all nodes
list_nodes()

# List all connections
list_edges()

Step 2: Identify Changes Needed

Based on the edit request, determine:

1. Node modifications: Change config, title, or position
2. Node additions: Add new nodes to the flow
3. Node deletions: Remove nodes (and their edges)
4. Connection changes: Add/remove edges between nodes
5. Restructuring: Reorder or reroute the flow

Step 3: Apply PATCH-Style Updates

Critical Rule: Only change what needs to change. Don't recreate nodes unnecessarily.

Common Edit Operations

Modify Node Configuration

# 1. Get current node state
node = get_node(node_id="target-node-id")

# 2. Get schema to understand options
get_node_schema(block_type=node["data"]["type"])

# 3. Apply PATCH update - only changed fields
edit_node(
    node_id="target-node-id",
    config={
        # Only include fields you're changing
        "model": {
            "name": "claude-3-opus"  # Just changing model name
        }
    }
)

Change Node Title

edit_node(
    node_id="target-node-id",
    title="New Descriptive Title"
)

Update Node Position

edit_node(
    node_id="target-node-id",
    position={"x": 300, "y": 150}
)

Add a Node Between Existing Nodes

# Current: A → B
# Desired: A → NEW → B

# 1. Find the edge to break
edges = list_edges()
edge_to_remove = <find A→B edge>

# 2. Remove old connection
disconnect_nodes(source_id="A", target_id="B")

# 3. Add new node
result = add_node(
    node_type="...",
    config={...},
    after_node_id="A"
)
new_node_id = result["node_id"]

# 4. Connect new node to B
connect_nodes(source_id=new_node_id, target_id="B")