Skip to main content
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

​
agent_id
string
required
Agent UUID. Used to scope validation (e.g., to check that referenced action IDs exist).

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request body

​
flow_config
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/branches targets, required fields per node type.