REST

URL base: https://valorbrain-api.valor.digital

curl -sS https://valorbrain-api.valor.digital/health

Auth: Authorization: Bearer <vb_agent_ or other engine token>.

O tenant é resolvido a partir do token. Você não precisa de X-Tenant-ID para uma chave normal.

Busca

curl -sS -X POST https://valorbrain-api.valor.digital/search \
  -H "Authorization: Bearer $VALORBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"deploy key","limit":5}'

Opcional: "profile": "speed" para o caminho rápido (híbrido/FTS, sem cross-encoder). O padrão é balanced. "timing": true ou o header x-search-timing: 1 adiciona hybrid_ms / rerank_ms / graph_ms / total_ms.

POST /retrieve é a gêmea multiestratégia da busca (memory_retrieve no MCP roteia sozinho; esta é a forma explícita REST).

Ingestão

curl -sS -X POST https://valorbrain-api.valor.digital/documents \
  -H "Authorization: Bearer $VALORBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": "decisions",
    "path": "ADR-001.md",
    "title": "We chose PostgreSQL",
    "content": "## Decision\nPostgreSQL is the primary store."
  }'

É isso que o add da CLI chama.

Ingestão SaaS (chave de API do workspace)

Para sistemas que já falam com o app, não com o engine:

curl -sS -X POST https://valorbrain.valor.digital/api/v1/ingest \
  -H "Authorization: Bearer fk_<id>.sk_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": "decisions",
    "path": "ADR-001.md",
    "title": "We chose PostgreSQL",
    "content": "## Decision\nPostgreSQL is the primary store."
  }'

Chaves fk_ autenticam a ingestão no host SaaS. Elas não substituem a busca no engine em valorbrain-api.

Leitura / curadoria

O arquivo OpenAPI do engine no repositório descreve 116 paths, incluindo ops e graph. O JSON em valorbrain.valor.digital/openapi.json é um documento de descoberta de 4 paths para agentes que acessam o site de marketing. Não é a mesma spec. Este site de docs publica a superfície pública de integração; veja a Referência de API.

Cadastro de agente (REST)

curl -sS -X POST https://valorbrain-api.valor.digital/api/v1/agents/signup \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent","agent_caller":"claude-code"}'

Precisa acertar o valorbrain-api. O mesmo path no mcpbrain é engolido pelo transporte MCP.

Tabela completa: Referência REST.