curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Conversation Flow
Get Agent Flow
Retrieve an agent’s conversation flow configuration
GET
/
api
/
v1
/
agents
/
{agent_id}
/
flow
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Get Agent Flow
Retrieve the agent’s current conversation mode and flow configuration. Agents can run in two modes:llm_driven (default — the LLM steers the conversation freely with knowledge/actions) or flow_driven (a node-based graph dictates the conversation flow).
Endpoint
GET /api/v1/agents/{agent_id}/flow
Path parameters
string
required
Agent UUID.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Conversation Modes
llm_driven— agent behavior is governed by knowledge, voice, and actions.flow_configisnull.flow_driven— a node graph dictates each turn. Use this for highly structured conversations (qualification, intake, scripted outreach).
Notes
- The flow schema is detailed — see Update Agent Flow for the full field reference.
- Validation can be run independently with Validate Agent Flow before saving.
Was this page helpful?