Skip to main content
PUT
/
api
/
v1
/
assistant-graphs
/
{graph_id}
curl -X PUT https://api.burki.dev/api/v1/assistant-graphs/1 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Customer Service Router",
    "description": "Routes customers to sales, support, or billing"
  }'

{
  "id": 1,
  "organization_id": 1,
  "name": "Updated Customer Service Router",
  "description": "Routes customers to sales, support, or billing",
  "is_active": true,
  "configuration": {},
  "nodes": [
    {
      "id": 101,
      "graph_id": 1,
      "assistant_id": 1,
      "node_type": "entry",
      "position": {"x": 0, "y": 0},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Receptionist",
      "assistant_description": "Greets callers and routes to departments"
    }
  ],
  "edges": [
    {
      "id": 201,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 102,
      "condition_type": "intent",
      "intent_pattern": "sales,purchase,buy",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "Let me connect you with our sales team.",
      "created_at": "2025-01-19T10:00:00Z",
      "updated_at": "2025-01-19T10:00:00Z"
    }
  ],
  "total_nodes": 3,
  "total_edges": 2,
  "created_at": "2025-01-19T10:00:00Z",
  "updated_at": "2025-01-19T15:30:00Z"
}
Update the metadata of an existing assistant graph. This endpoint updates only the graph-level properties like name, description, and configuration. To update nodes and edges, use the Update Structure endpoint.

​
Path Parameters

​
graph_id
integer
required
The unique identifier of the graph to update.

​
Request Body

Only fields provided in the request will be updated.
​
name
string
New name for the graph. Must be unique within your organization.
​
description
string
New description for the graph.
​
is_active
boolean
Whether the graph should be active. Set to false to disable the graph without deleting it.
​
configuration
object
Graph-level configuration settings.

​
Response

Returns the updated graph object with full details including nodes and edges.
​
id
integer
Unique identifier for the graph.
​
organization_id
integer
Organization that owns this graph.
​
name
string
Updated name of the graph.
​
description
string
Updated description of the graph.
​
is_active
boolean
Whether the graph is active.
​
nodes
array
Array of nodes (unchanged by this endpoint).
​
edges
array
Array of edges (unchanged by this endpoint).
​
updated_at
string
ISO 8601 timestamp of the update.
curl -X PUT https://api.burki.dev/api/v1/assistant-graphs/1 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Customer Service Router",
    "description": "Routes customers to sales, support, or billing"
  }'

{
  "id": 1,
  "organization_id": 1,
  "name": "Updated Customer Service Router",
  "description": "Routes customers to sales, support, or billing",
  "is_active": true,
  "configuration": {},
  "nodes": [
    {
      "id": 101,
      "graph_id": 1,
      "assistant_id": 1,
      "node_type": "entry",
      "position": {"x": 0, "y": 0},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Receptionist",
      "assistant_description": "Greets callers and routes to departments"
    }
  ],
  "edges": [
    {
      "id": 201,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 102,
      "condition_type": "intent",
      "intent_pattern": "sales,purchase,buy",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "Let me connect you with our sales team.",
      "created_at": "2025-01-19T10:00:00Z",
      "updated_at": "2025-01-19T10:00:00Z"
    }
  ],
  "total_nodes": 3,
  "total_edges": 2,
  "created_at": "2025-01-19T10:00:00Z",
  "updated_at": "2025-01-19T15:30:00Z"
}

​
Error Responses

Status CodeDescription
401Unauthorized - Invalid or missing API key
404Graph not found in your organization
500Server error updating the graph
To update the graph structure (nodes and edges), use the Update Structure endpoint instead.