REST

Referencia API

MemoryFirst expone una API REST nativa. La misma memoria es accesible por MCP (ver la guía de MCP).

URL base

https://api.memoryfirst.ai/v1

Autenticación

Todas las solicitudes requieren una clave API en la cabecera Authorization :

curl https://api.memoryfirst.ai/v1/experts/{expertId}/query \
  -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"question": "What did we promise this client?", "k": 8}'

Endpoints

  • POST /v1/experts/{id}/sources: procesar una nueva fuente
  • POST /v1/experts/{id}/query: consultar memoria con citas
  • GET /v1/experts: listar expertos en tu workspace
  • POST /v1/experts: crear nuevo experto
  • GET /v1/usage: estadísticas de uso del periodo actual
  • POST /v1/brain/event: registra un evento del cerebro (decisión, bloqueo, despliegue, contacto con cliente). Responde 202 con el id del evento.

Reintentos sin duplicados: Idempotency-Key

Si tu cliente reintenta tras un corte de red o reenvía una bandeja de salida, manda la cabecera Idempotency-Key en POST /v1/brain/event con una clave tuya (1 a 255 caracteres ASCII imprimibles, sin espacios). La misma clave del mismo workspace devuelve, durante 24 horas, el evento ya creado con 200 e idempotent_replay: true, y no crea otro.

curl https://api.memoryfirst.ai/v1/brain/event \
  -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: outbox-2026-11-13-0042" \
  -H "Content-Type: application/json" \
  -d '{"project": "my-project", "event_type": "decision_taken", "title": "Move blobs to R2"}'

Si el cuerpo repetido es distinto, se devuelve el evento original sin cambios y payload_differs: true. La misma clave con otro proyecto responde 422; mientras la primera petición sigue en curso, 409 (reintenta con la misma clave). Con la herramienta MCP mf_record, pasa el argumento idempotency_key.

Especificación OpenAPI 3.1 completa próximamente. Escribe a hola [at] memoryfirst.ai para acceso anticipado.