Pular para conteúdo principal
Documentação
REST API — Base URL: https://sofiaia.roilabs.com.br

API Reference

Integre o Sofia AI diretamente nas suas aplicações via REST API.

Autenticação

Todas as rotas autenticadas exigem cookie de sessão via NextAuth ou header Authorization: Bearer TOKEN.

POST /api/auth/login
Content-Type: application/json

{ "email": "seu@email.com", "password": "senha" }

Autenticação

POST/api/auth/register
POST/api/auth/login
POST/api/auth/logout

Agentes

GET/api/agents
POST/api/agents
GET/api/agents/:id
PUT/api/agents/:id
DELETE/api/agents/:id

Orquestrações

GET/api/orchestrations
POST/api/orchestrations
POST/api/orchestrations/:id/execute
GET/api/orchestrations/executions

Knowledge Base

GET/api/knowledge
POST/api/knowledge
POST/api/knowledge/:id/upload
GET/api/knowledge/:id/chunks

Webhooks

POST/api/webhooks/mercadopago

Streaming SSE — Execução de Orquestrações

Execuções retornam Server-Sent Events (SSE) com updates em tempo real por agente.

const es = new EventSource('/api/orchestrations/ID/execute?input=...')
es.onmessage = (e) => {
  const data = JSON.parse(e.data)
  // data.type: 'agent_start' | 'agent_chunk' | 'agent_complete' | 'done'
  // data.agentName, data.content, data.metrics
}