Referencia REST API

Todos los endpoints requieren un token Bearer. Obtenga su token desde el panel de control.

# URL base

https://api.agent-memo.ai

# Encabezado de autenticación

Authorization: Bearer YOUR_API_KEY

Memorias

GET/api/memories

Listar memorias con filtros opcionales

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

POST/api/memories

Crear una nueva memoria

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }
GET/api/memories/:id

Obtener una memoria por ID

PUT/api/memories/:id

Actualizar una memoria existente

{ "content": "updated content", "importance": 3 }
DELETE/api/memories/:id

Eliminar una memoria

POST/api/memories/search

Búsqueda semántica en las memorias

{ "query": "database choice", "type": ["project"], "limit": 5 }
GET/api/memories/topics

Listar todos los temas con conteo de memorias

POST/api/memories/check-duplicate

Verificar duplicados semánticos antes de almacenar

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

Grafo de Conocimiento

POST/api/kg/add

Agregar una relación de entidad (hecho)

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }
POST/api/kg/query

Consultar relaciones entre entidades

{ "entity": "auth-service", "direction": "outgoing" }
POST/api/kg/invalidate

Invalidar un hecho (marcar como ya no verdadero)

{ "factId": "..." }
POST/api/kg/timeline

Ver línea de tiempo de hechos de una entidad

{ "entity": "auth-service" }
GET/api/kg/stats

Estadísticas del grafo de conocimiento

Formato de respuesta

Todas las respuestas son JSON. Las respuestas exitosas devuelven los datos directamente. Los errores devuelven un objeto JSON con un campo de error.

Éxito (200)

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

Error (4xx/5xx)

{
  "error": "Memory not found"
}

Límites de velocidad

Durante la beta, no hay límites de velocidad forzados. Sea un buen ciudadano — el uso típico está muy por debajo de 100 solicitudes/minuto. Los límites de velocidad se introducirán con los planes de pago.