Référence API REST

Tous les endpoints nécessitent un token Bearer. Obtenez votre token depuis le tableau de bord.

# URL de base

https://api.agent-memo.ai

# En-tête d'authentification

Authorization: Bearer YOUR_API_KEY

Mémoires

GET/api/memories

Lister les mémoires avec filtres optionnels

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

POST/api/memories

Créer une nouvelle mémoire

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

GET/api/memories/:id

Obtenir une mémoire par ID

PUT/api/memories/:id

Mettre à jour une mémoire existante

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

DELETE/api/memories/:id

Supprimer une mémoire

POST/api/memories/search

Recherche sémantique dans les mémoires

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

GET/api/memories/topics

Lister tous les sujets avec le nombre de mémoires

POST/api/memories/check-duplicate

Vérifier les doublons sémantiques avant le stockage

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

Graphe de connaissances

POST/api/kg/add

Ajouter une relation entre entités (fait)

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

POST/api/kg/query

Interroger les relations entre entités

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

POST/api/kg/invalidate

Invalider un fait (marquer comme n'étant plus vrai)

{ "factId": "..." }

POST/api/kg/timeline

Voir la chronologie des faits pour une entité

{ "entity": "auth-service" }

GET/api/kg/stats

Statistiques du graphe de connaissances

Format de réponse

Toutes les réponses sont en JSON. Les réponses réussies renvoient les données directement. Les erreurs renvoient un objet JSON avec un champ error.

Succès (200)

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

Erreur (4xx/5xx)

{
  "error": "Memory not found"
}

Limites de débit

Pendant la bêta, il n'y a pas de limites de débit imposées. Soyez raisonnable — l'utilisation typique est bien en dessous de 100 requêtes/minute. Les limites de débit seront introduites avec les plans payants.