curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
{
"success": true,
"message": "Flow is valid"
}
Conversation Flow
Validate Agent Flow
Dry-run validation of a flow configuration
POST
/
api
/
v1
/
agents
/
{agent_id}
/
flow
/
validate
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
{
"success": true,
"message": "Flow is valid"
}
Validate Agent Flow
Run validation on a candidate flow configuration without persisting changes. Returns the same errors that Update Agent Flow would return.Endpoint
POST /api/v1/agents/{agent_id}/flow/validate
Path parameters
string
required
Agent UUID. Used to scope validation (e.g., to check that referenced action IDs exist).
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
object
required
Same shape as in Update Agent Flow.
Examples
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
Response
Valid
{
"success": true,
"message": "Flow is valid"
}
Invalid
{
"success": false,
"errors": [
"Duplicate node id: 'node-greet'",
"Node 'node-end' is unreachable"
]
}
Notes
- Use this from your editor before submitting an update — surfaces issues early without modifying agent state.
- Validation rules cover: unique node IDs, reachability, valid
next/branchestargets, required fields per nodetype.
Was this page helpful?