Pular para o conteúdo principal
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.

​
Validar Fluxo do Agente

Executa a validação em uma configuração de fluxo candidata sem persistir alterações. Retorna os mesmos erros que Atualizar Fluxo do Agente retornaria.

​
Endpoint

POST /api/v1/agents/{agent_id}/flow/validate

​
Parâmetros de Caminho

​
agent_id
string
obrigatório
UUID do agente. Usado para delimitar a validação (ex: para verificar se IDs de ações referenciados existem).

​
Cabeçalhos da Requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Corpo da Requisição

​
flow_config
object
obrigatório
Mesmo formato de Atualizar Fluxo do Agente.

​
Exemplos

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

​
Resposta

​
Válido

{
  "success": true,
  "message": "Flow is valid"
}

​
Inválido

{
  "success": false,
  "errors": [
    "Duplicate node id: 'node-greet'",
    "Node 'node-end' is unreachable"
  ]
}

​
Observações

  • Use este endpoint a partir do seu editor antes de submeter uma atualização — expõe problemas cedo, sem modificar o estado do agente.
  • As regras de validação cobrem: IDs de nó únicos, alcançabilidade, alvos válidos de next/branches e campos obrigatórios por type de nó.