API-Referenz
MemoryFirst stellt eine native REST-API bereit. Dasselbe Gedächtnis ist per MCP erreichbar (siehe MCP-Leitfaden).
Basis-URL
https://api.memoryfirst.ai/v1
Authentifizierung
Alle Anfragen erfordern einen API-Schlüssel im Header 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}'Endpunkte
POST /v1/experts/{id}/sources: eine neue Quelle verarbeitenPOST /v1/experts/{id}/query: das Gedächtnis mit Belegen abfragenGET /v1/experts: Experten in Ihrem Workspace auflistenPOST /v1/experts: neuen Experten anlegenGET /v1/usage: Nutzungsstatistiken des laufenden ZeitraumsPOST /v1/brain/event: erfasst ein Ereignis des Brains (Entscheidung, Blocker, Deployment, Kundenkontakt). Antwortet mit 202 und der ID des Ereignisses.
Wiederholungen ohne Duplikate: Idempotency-Key
Wenn Ihr Client nach einem Netzausfall erneut sendet oder einen Postausgang erneut übermittelt, senden Sie den Header Idempotency-Key bei POST /v1/brain/event mit einem eigenen Schlüssel (1 bis 255 druckbare ASCII-Zeichen, ohne Leerzeichen). Derselbe Schlüssel im selben Workspace liefert 24 Stunden lang das bereits angelegte Ereignis mit 200 und idempotent_replay: true zurück und legt kein weiteres an.
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"}'Ist der wiederholte Body anders, wird das ursprüngliche Ereignis unverändert zurückgegeben, mit payload_differs: true. Derselbe Schlüssel mit einem anderen Projekt antwortet mit 422; solange die erste Anfrage noch läuft, mit 409 (erneut mit demselben Schlüssel versuchen). Beim MCP-Tool mf_record übergeben Sie das Argument idempotency_key.
Die vollständige OpenAPI-3.1-Spezifikation folgt in Kürze. Schreiben Sie an hola [at] memoryfirst.ai für frühen Zugang.