API
Referência REST
Rotas do engine voltadas ao cliente. O host é sempre valorbrain-api.valor.digital.
Auth: Authorization: Bearer <token>. O tenant vem do token.
Engine (valorbrain-api)
| Método | Path | Notas |
|---|---|---|
GET | /health | Liveness. Sem auth. |
GET | /healthz | Alias. |
POST | /search | Busca híbrida. Body: { query, limit?, profile?, timing? }. |
POST | /retrieve | Recuperação multiestratégia. |
POST | /documents | Ingestão. Body: { collection, path?, title?, content, … }. |
GET | /documents | Lista, paginada. |
GET | /documents/:id | Documento completo. |
POST | /documents/:id/pin | Pin. |
POST | /documents/:id/snooze | Snooze. |
POST | /documents/:id/forget | Soft-delete. |
POST | /documents/:id/feedback | Avaliação. |
PATCH | /documents/:id/visibility | Visibilidade. |
DELETE | /documents/purge | Purga dos esquecidos. Destrutivo — escopado no tenant. |
GET | /collections | Coleções e contagens. |
GET | /stats | Estatísticas do índice. |
GET | /sessions | Resumos recentes de sessão. |
GET | /timeline/:id | Vizinhança temporal. |
GET | /graph/similar/:id | Vizinhos semânticos. |
GET | /graph/causal/:id | Links causais. |
POST | /api/v1/agents/signup | Conta de agente. Devolve chave vb_agent_. |
POST | /api/v1/agents/identify | Backfill de agent_caller. |
POST | /api/v1/agents/claim | Inicia claim de email. |
POST | /api/v1/agents/claim/verify | Conclui o claim. Mesma chave. |
POST | /api/v1/memory/prepare | Gêmea do memory_prepare do MCP. |
POST | /api/v1/memory/store | Gêmea do memory_store do MCP. |
Rotas de grafo, decisões, proveniência, conflitos e ops existem no engine
(116 paths em docs/reference/openapi.yaml). Elas são reais; não são a
primeira integração. Use decisions / provenance / conflicts no MCP ou
leia o OpenAPI do engine no repositório se precisar delas.
SaaS (valorbrain.valor.digital)
| Método | Path | Auth |
|---|---|---|
POST | /api/v1/ingest | fk_….sk_… |
GET | /openapi.json | Público, 4 paths de descoberta |
GET | /llms.txt | Brief público de marketing |
GET | /.well-known/mcp/server-card.json | Público |
Não é REST
https://mcpbrain.valor.digital/mcp é MCP. O OAuth vive nesse host. Enviar
/search lá falha com 401.