List Graphs

List all assistant graphs in your organization

GET /api/v1/assistant-graphs

cURL

curl https://api.burki.dev/api/v1/assistant-graphs \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

[
  {
    "id": 1,
    "organization_id": 1,
    "name": "Customer Service Router",
    "description": "Routes customers to the appropriate department",
    "is_active": true,
    "configuration": {},
    "nodes": [],
    "edges": [],
    "total_nodes": 4,
    "total_edges": 3,
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-19T14:30:00Z"
  },
  {
    "id": 2,
    "organization_id": 1,
    "name": "Language Router",
    "description": "Routes calls based on detected language",
    "is_active": true,
    "configuration": {},
    "nodes": [],
    "edges": [],
    "total_nodes": 4,
    "total_edges": 3,
    "created_at": "2025-01-10T08:00:00Z",
    "updated_at": "2025-01-18T11:00:00Z"
  }
]

Retrieve a list of all assistant graphs belonging to your organization, with optional filtering by status.

Query Parameters

skip · integer · default: "0"

Number of items to skip for pagination.

limit · integer · default: "100"

Maximum number of items to return. Must be between 1 and 1000.

active_only · boolean · default: "true"

When true, only returns active graphs. Set to false to include inactive graphs.

Response

Returns an array of graph objects. For list views, nodes and edges arrays are empty but total_nodes and total_edges counts are accurate.

[] · array

Array of assistant graphs.

Show Graph properties

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.

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

curl https://api.burki.dev/api/v1/assistant-graphs \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

[
  {
    "id": 1,
    "organization_id": 1,
    "name": "Customer Service Router",
    "description": "Routes customers to the appropriate department",
    "is_active": true,
    "configuration": {},
    "nodes": [],
    "edges": [],
    "total_nodes": 4,
    "total_edges": 3,
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-19T14:30:00Z"
  },
  {
    "id": 2,
    "organization_id": 1,
    "name": "Language Router",
    "description": "Routes calls based on detected language",
    "is_active": true,
    "configuration": {},
    "nodes": [],
    "edges": [],
    "total_nodes": 4,
    "total_edges": 3,
    "created_at": "2025-01-10T08:00:00Z",
    "updated_at": "2025-01-18T11:00:00Z"
  }
]

Error Responses

Status Code	Description
401	Unauthorized - Invalid or missing API key
500	Server error listing graphs

To get full node and edge details for a specific graph, use the Get Graph endpoint.