Skip to main content
GET
/
api
/
v1
/
assistant-graphs
/
{graph_id}
curl https://api.burki.dev/api/v1/assistant-graphs/1 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": 1,
  "organization_id": 1,
  "name": "Customer Service Router",
  "description": "Routes customers to the appropriate department",
  "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"
    },
    {
      "id": 102,
      "graph_id": 1,
      "assistant_id": 2,
      "node_type": "standard",
      "position": {"x": 200, "y": -100},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Sales Specialist",
      "assistant_description": "Handles sales inquiries"
    },
    {
      "id": 103,
      "graph_id": 1,
      "assistant_id": 3,
      "node_type": "standard",
      "position": {"x": 200, "y": 100},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Support Agent",
      "assistant_description": "Handles support requests"
    }
  ],
  "edges": [
    {
      "id": 201,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 102,
      "condition_type": "intent",
      "intent_pattern": "sales,purchase,buy",
      "natural_language_trigger": null,
      "mathematical_expression": null,
      "state_variable_condition": null,
      "condition_logic": "AND",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "Let me connect you with our sales team.",
      "description": "Route to sales on purchase intent",
      "created_at": "2025-01-19T10:00:00Z",
      "updated_at": "2025-01-19T10:00:00Z"
    },
    {
      "id": 202,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 103,
      "condition_type": "intent",
      "intent_pattern": "support,help,issue,problem",
      "natural_language_trigger": null,
      "mathematical_expression": null,
      "state_variable_condition": null,
      "condition_logic": "AND",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "I will transfer you to our support team.",
      "description": "Route to support on help intent",
      "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-19T10:00:00Z"
}
Get the complete details of a specific assistant graph, including all nodes, edges, and configuration.

​
Path Parameters

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

​
Response

​
id
integer
Unique identifier for the graph.
​
organization_id
integer
Organization that owns this graph.
​
name
string
Name of the graph.
​
description
string
Description of the graph.
​
is_active
boolean
Whether the graph is active.
​
configuration
object
Graph-level configuration settings.
​
nodes
array
Array of nodes with full details.
​
edges
array
Array of edges with full details.
​
total_nodes
integer
Total number of nodes in the graph.
​
total_edges
integer
Total number of edges in the graph.
​
created_at
string
ISO 8601 timestamp of creation.
​
updated_at
string
ISO 8601 timestamp of last update.
curl https://api.burki.dev/api/v1/assistant-graphs/1 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": 1,
  "organization_id": 1,
  "name": "Customer Service Router",
  "description": "Routes customers to the appropriate department",
  "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"
    },
    {
      "id": 102,
      "graph_id": 1,
      "assistant_id": 2,
      "node_type": "standard",
      "position": {"x": 200, "y": -100},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Sales Specialist",
      "assistant_description": "Handles sales inquiries"
    },
    {
      "id": 103,
      "graph_id": 1,
      "assistant_id": 3,
      "node_type": "standard",
      "position": {"x": 200, "y": 100},
      "configuration": {},
      "created_at": "2025-01-19T10:00:00Z",
      "assistant_name": "Support Agent",
      "assistant_description": "Handles support requests"
    }
  ],
  "edges": [
    {
      "id": 201,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 102,
      "condition_type": "intent",
      "intent_pattern": "sales,purchase,buy",
      "natural_language_trigger": null,
      "mathematical_expression": null,
      "state_variable_condition": null,
      "condition_logic": "AND",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "Let me connect you with our sales team.",
      "description": "Route to sales on purchase intent",
      "created_at": "2025-01-19T10:00:00Z",
      "updated_at": "2025-01-19T10:00:00Z"
    },
    {
      "id": 202,
      "graph_id": 1,
      "from_node_id": 101,
      "to_node_id": 103,
      "condition_type": "intent",
      "intent_pattern": "support,help,issue,problem",
      "natural_language_trigger": null,
      "mathematical_expression": null,
      "state_variable_condition": null,
      "condition_logic": "AND",
      "priority": 1,
      "is_active": true,
      "handoff_sentence": "I will transfer you to our support team.",
      "description": "Route to support on help intent",
      "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-19T10:00:00Z"
}

​
Error Responses

Status CodeDescription
401Unauthorized - Invalid or missing API key
404Graph not found in your organization
500Server error retrieving the graph