Skip to main content
The SDK mirrors the node-and-edge model of the Voice Agent Builder. You create a Workflow, add nodes (startCall, agentNode, endCall, …) with add(), connect them with edge(), and persist the result via save_workflow.

​
Prerequisites

​
Build and save

The example below builds a three-node loan-qualification agent and saves it as a new draft version on an existing agent. Your published agent keeps serving calls until you explicitly publish the draft. 
from dograh_sdk import DograhClient, Workflow

with DograhClient(api_key="YOUR_API_KEY") as client:
    wf = Workflow(client=client, name="loan_qualification")

    greeting = wf.add(
        type="startCall",
        name="greeting",
        prompt="You are Sarah from Acme Loans. Greet the caller warmly.",
    )
    qualify = wf.add(
        type="agentNode",
        name="qualify",
        prompt="Ask about loan amount, purpose, and monthly income.",
    )
    done = wf.add(
        type="endCall",
        name="done",
        prompt="Thank them and end the call politely.",
    )

    wf.edge(greeting, qualify, label="interested", condition="Caller wants to continue.")
    wf.edge(qualify, done, label="done", condition="All qualification questions answered.")

    client.save_workflow(workflow_id=123, workflow=wf)

​
Edit an existing agent

Load an agent into an editable Workflow, mutate it, then save: 
wf = client.load_workflow(workflow_id=123)
wf.name = "loan_qualification_v2"
client.save_workflow(workflow_id=123, workflow=wf)

​
Discover node types

Each node’s type string and required fields come from the backend’s node-spec catalog. Fetch it at runtime to validate what you can build: 
types = client.list_node_types()
for spec in types.node_types:
    print(spec.name, [p.name for p in spec.properties])
For a full description of each node type and its fields, see the Nodes section of the Voice Agent Builder docs.