REST

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 verarbeiten
  • POST /v1/experts/{id}/query: das Gedächtnis mit Belegen abfragen
  • GET /v1/experts: Experten in Ihrem Workspace auflisten
  • POST /v1/experts: neuen Experten anlegen
  • GET /v1/usage: Nutzungsstatistiken des laufenden Zeitraums
  • POST /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.