Usuario

Gestión completa del perfil, preferencias, claves API, servidores MCP, notificaciones, gamificación, estadísticas de IA y funciones sociales.

Settings

Perfil del usuario y preferencias de la aplicación.

GET /api/user/settings Obtener el perfil y las preferencias del usuario.

PATCH /api/user/settings Actualizar el perfil y/o las preferencias del usuario. Todos los campos son opcionales.

API Keys

Crea y revoca claves para acceso programático. La clave en texto plano solo se muestra una vez al crearla.

GET /api/user/api-keys Listar todas las API keys del usuario autenticado (los valores en texto plano nunca se devuelven).

POST /api/user/api-keys Crear una nueva API key. El valor en texto plano se incluye en la respuesta solo una vez.

DELETE /api/user/api-keys Revocar y eliminar permanentemente una API key por ID.

MCP Servers

Registra y gestiona servidores MCP para integrar herramientas externas con el agente.

GET /api/user/mcp-servers Listar todos los servidores MCP registrados para el usuario autenticado.

POST /api/user/mcp-servers Registrar un nuevo servidor MCP.

PATCH /api/user/mcp-servers/:serverId Actualizar el nombre, URL o transport de un servidor MCP registrado.

DELETE /api/user/mcp-servers/:serverId Eliminar un servidor MCP registrado.

POST /api/user/mcp-servers/:serverId/test Probar la conectividad con un servidor MCP registrado.

Notifications

Consulta y marca como leídas las notificaciones del usuario.

GET /api/user/notifications Listar las notificaciones paginadas del usuario autenticado.

PATCH /api/user/notifications Marcar todas las notificaciones como leídas.

PATCH /api/user/notifications/:notificationId Marcar una notificación individual como leída.

Engagement & Stats

Gamificación, estadísticas de uso de IA, digest personalizado y cola de repaso espaciado.

GET /api/user/engagement Obtener XP, nivel, racha y badges. Otorga XP de inicio de sesión diario en la primera llamada del día.

GET /api/user/stats Estadísticas de uso de IA — tokens totales consumidos, sesiones de chat y mensajes enviados.

GET /api/user/digest Obtener el digest de aprendizaje personalizado del usuario autenticado.

POST /api/user/digest Forzar la regeneración inmediata del digest de aprendizaje personalizado.

GET /api/user/review-queue Obtener los conceptos pendientes de repaso de repetición espaciada, ordenados por urgencia.

Social

Feed de actividad, perfiles públicos, seguir/dejar de seguir usuarios y búsqueda.

GET /api/user/activity Feed de actividad agregado de los usuarios que sigue el usuario autenticado.

GET /api/users/:userId Obtener el perfil público de un usuario.

POST /api/users/:userId/follow Seguir a un usuario.

DELETE /api/users/:userId/follow Dejar de seguir a un usuario.

GET /api/users/:userId/followers Listar los seguidores de un usuario.

GET /api/users/:userId/following Listar los usuarios que sigue un usuario.

GET /api/users/search Buscar usuarios por nombre de visualización o nombre de usuario.