REST API Referenz

Alle Endpunkte erfordern einen Bearer Token. Holen Sie Ihren Token aus dem Dashboard.

# Basis-URL

https://api.agent-memo.ai

# Authentifizierungs-Header

Authorization: Bearer YOUR_API_KEY

Erinnerungen

GET/api/memories

Erinnerungen mit optionalen Filtern auflisten

Query: ?topic=&type=&importance=&limit=&offset=

POST/api/memories

Neue Erinnerung erstellen

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }

GET/api/memories/:id

Einzelne Erinnerung nach ID abrufen

PUT/api/memories/:id

Bestehende Erinnerung aktualisieren

{ "content": "updated content", "importance": 3 }

DELETE/api/memories/:id

Erinnerung löschen

POST/api/memories/search

Semantische Suche über Erinnerungen

{ "query": "database choice", "type": ["project"], "limit": 5 }

GET/api/memories/topics

Alle Themen mit Erinnerungsanzahl auflisten

POST/api/memories/check-duplicate

Auf semantische Duplikate prüfen vor dem Speichern

{ "content": "...", "threshold": 0.92 }

Wissensgraph

POST/api/kg/add

Entitätsbeziehung (Fakt) hinzufügen

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }

POST/api/kg/query

Entitätsbeziehungen abfragen

{ "entity": "auth-service", "direction": "outgoing" }

POST/api/kg/invalidate

Fakt ungültig machen (als nicht mehr gültig markieren)

{ "factId": "..." }

POST/api/kg/timeline

Zeitverlauf der Fakten für eine Entität anzeigen

{ "entity": "auth-service" }

GET/api/kg/stats

Wissensgraph-Statistiken

Antwortformat

Alle Antworten sind JSON. Erfolgreiche Antworten geben die Daten direkt zurück. Fehler geben ein JSON-Objekt mit einem Fehlerfeld zurück.

Erfolg (200)

{
  "id": "abc-123",
  "content": "Use PostgreSQL",
  "type": "project",
  "topic": "database",
  "importance": 3,
  "created_at": "2026-04-08T..."
}

Fehler (4xx/5xx)

{
  "error": "Memory not found"
}

Ratenbegrenzungen

Während der Beta gibt es keine erzwungenen Ratenbegrenzungen. Seien Sie fair — typische Nutzung liegt weit unter 100 Anfragen/Minute. Ratenbegrenzungen werden mit kostenpflichtigen Plänen eingeführt.