REST

Référence API

MemoryFirst expose une API REST native. La même mémoire est accessible par MCP (voir le guide MCP).

URL de base

https://api.memoryfirst.ai/v1

Authentification

Toutes les requêtes nécessitent une clé API dans l'en-tête 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: traiter une nouvelle source
  • POST /v1/experts/{id}/query: interroger la mémoire avec citations
  • GET /v1/experts: lister les experts de votre workspace
  • POST /v1/experts: créer un nouvel expert
  • GET /v1/usage: statistiques d'utilisation de la période en cours
  • POST /v1/brain/event: enregistre un événement du cerveau (décision, blocage, déploiement, contact client). Répond 202 avec l'id de l'événement.

Nouvelles tentatives sans doublons : Idempotency-Key

Si votre client réessaie après une coupure réseau ou renvoie une boîte d'envoi, envoyez l'en-tête Idempotency-Key dans POST /v1/brain/event avec une clé de votre choix (1 à 255 caractères ASCII imprimables, sans espaces). La même clé du même workspace renvoie, pendant 24 heures, l'événement déjà créé avec un 200 et idempotent_replay: true, sans en créer un autre.

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 le corps répété est différent, l'événement original est renvoyé sans modification et avec payload_differs: true. La même clé avec un autre projet répond 422 ; tant que la première requête est en cours, 409 (réessayez avec la même clé). Avec l'outil MCP mf_record, passez l'argument idempotency_key.

Spécification OpenAPI 3.1 complète : bientôt disponible. Écrivez à hola [at] memoryfirst.ai pour un accès anticipé.