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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.