Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Create, update, list, delete, and assign phone numbers to ConversationFlows.
/api/v1/flows. They are the current orchestration API for multi-step call routing.
{
"id": 42,
"organization_id": 1,
"base_assistant_id": 123,
"name": "Customer Support Flow",
"graph": {
"begin_node": "start",
"global_prompt": "Be concise.",
"nodes": {
"start": {
"type": "conversation",
"prompt": "Greet the caller.",
"transitions": [
{
"kind": "prompt",
"to": "support",
"when": "The caller needs support."
}
]
},
"support": {
"type": "conversation",
"prompt": "Help the caller with support questions."
}
}
},
"is_active": true,
"created_at": "2026-04-29T14:00:00Z",
"updated_at": "2026-04-29T14:00:00Z"
}
| Field | Type | Description |
|---|---|---|
active_only | boolean | Defaults to true. When true, returns only active flows. |
curl "https://api.burki.dev/api/v1/flows?active_only=true" \
-H "Authorization: Bearer $BURKI_API_KEY"
{
"name": "Customer Support Flow",
"base_assistant_id": 123,
"graph": {
"begin_node": "start",
"nodes": {
"start": {
"type": "conversation",
"prompt": "Greet the caller and ask how you can help."
}
}
},
"is_active": true
}
base_assistant_id and graph can be omitted to let the backend create a starter assistant and one-node starter flow.
curl https://api.burki.dev/api/v1/flows/42 \
-H "Authorization: Bearer $BURKI_API_KEY"
name, base_assistant_id, graph, and is_active.
curl -X PUT https://api.burki.dev/api/v1/flows/42 \
-H "Authorization: Bearer $BURKI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"is_active": false}'
curl -X POST https://api.burki.dev/api/v1/flows/42/phone-numbers/7/assign \
-H "Authorization: Bearer $BURKI_API_KEY"
curl -X POST https://api.burki.dev/api/v1/flows/42/phone-numbers/7/unassign \
-H "Authorization: Bearer $BURKI_API_KEY"