workBrain Live API

v0.1.0

API HTTP autenticada que responde preguntas en lenguaje natural sobre el vault de conocimiento de trabajo (Kamron / Execution OS), con citas a las páginas fuente.

Cómo funciona

01 · RETRIEVE

Picker

Gemini Flash lee el índice del vault y elige hasta 12 páginas relevantes.

02 · EXPAND

Link-hop

Carga esas páginas y sigue un salto de [[wikilinks]].

03 · ANSWER

Synth

Gemini Pro sintetiza una respuesta en español con citas [[carpeta/slug]].

Endpoints

GET /api/health

Liveness check. Sin auth.

curl https://workbrain-api.vercel.app/api/health
# → {"ok":true}
POST /api/ask

Pregunta al workBrain. Requiere header Authorization: Bearer <WORKBRAIN_API_KEY>. 

curl -X POST https://workbrain-api.vercel.app/api/ask \
  -H "Authorization: Bearer $WORKBRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Quien es JCK?"}'

Response:

{
  "answer": "JCK es el COO de [[entities/ascendancy]]...",
  "citations": ["entities/jck", "entities/ascendancy"],
  "pages_read":  ["entities/jck", "entities/ascendancy", "concepts/..."]
}

Status codes: 200 ok · 400 falta question · 401 auth · 405 método · 500 error interno.

Playground

Ejemplo: fetch (JS)

const r = await fetch("/api/ask", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.WORKBRAIN_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ question: "Que es shared context en Execution OS?" })
});
const { answer, citations, pages_read } = await r.json();