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 sourcePOST /v1/experts/{id}/query: interroger la mémoire avec citationsGET /v1/experts: lister les experts de votre workspacePOST /v1/experts: créer un nouvel expertGET /v1/usage: statistiques d'utilisation de la période en coursPOST /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é.