# Resumen de la API y URL base
SUMMARY: Todos los endpoints de la API de Synapse, URL base, patrones de autenticación y formatos de respuesta de un vistazo.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

Resumen de la API y URL base
La API de Synapse es una API HTTP RESTful. Todos los endpoints devuelven JSON
(excepto donde se indique lo contrario). Esta página cubre lo esencial que debe
conocer antes de profundizar en endpoints específicos.
URL base
[CODE BLOCK]
Todas las rutas de esta documentación son relativas a esta URL base. Para
instancias autoalojadas, sustitúyala por su propia URL.
Autenticación
Existen dos métodos, ambos enviados mediante la cabecera :
[CODE BLOCK]
O mediante el parámetro de consulta (limitado a 60/min):
[CODE BLOCK]
Consulte Autenticación para más detalles.
Grupos de endpoints
| Grupo | Auth | Descripción |
|-------|------|-------------|
| Public | Ninguna | Página de inicio, health, OpenAPI, docs |
| Memory | Mind Key | CRUD, búsqueda, sincronización, embeddings |
| Chat | Mind Key / JWT | Mensajería asíncrona entre humano y agente |
| Tasks | Mind Key | Gestión de tareas |
| Scripts | Mind Key / JWT | Almacén persistente de scripts |
| Scheduler | Mind Key | Trabajos cron + variables |
| Webhooks | Mind Key | Callbacks HTTP ante eventos |
| Computers | Mind Key / JWT | Control remoto de computadoras |
| User/Minds | JWT | Cuenta + gestión de minds |
| Sharing | JWT | Compartir minds entre usuarios |
| Push | JWT | Suscripciones Web Push |
| Tools | Ninguna | Hora, calculadora, aleatorios (utilidades públicas) |
Formatos de respuesta
- JSON (predeterminado): 
- Texto plano:  devuelve texto optimizado para LLM
- HTML: , , , , 
Envoltorio estándar de respuesta
Las respuestas exitosas devuelven los datos directamente:
[CODE BLOCK]
Las respuestas de error usan este formato:
[CODE BLOCK]
> [!NOTE]
> El campo  enlaza a la documentación relevante para errores comunes.
Códigos de estado HTTP
| Código | Significado |
|------|---------|
| 200 | Éxito (GET, PUT) |
| 201 | Creado (POST) |
| 204 | Sin contenido (DELETE) |
| 400 | Solicitud incorrecta (error de validación) |
| 401 | No autorizado (token ausente/inválido) |
| 403 | Prohibido (tipo de token incorrecto) |
| 404 | No encontrado (la ruta no existe) |
| 409 | Conflicto (duplicado) |
| 429 | Demasiadas solicitudes (límite de frecuencia) |
| 500 | Error del servidor |
Endpoints de descubrimiento
| Endpoint | Propósito |
|----------|---------|
|  | Página de inicio (optimizada para LLM) |
|  | Lista legible por máquina de todos los endpoints |
|  | Lista de endpoints en texto plano |
|  | Especificación OpenAPI 3.0 |
|  | Documentación completa de la API (HTML) |
|  | Documentación de la API en JSON |
|  | Sistema de documentación (HTML) |
|  | Índice de documentación (JSON) |
|  | Toda la documentación en un bloque de texto |
|  | Playground interactivo de la API |
Límites de frecuencia
| Método de auth | Límite |
|-------------|-------|
| Mind Key (cabecera) | Ninguno |
| Mind Key (?key=) | 60/min por IP |
| JWT (cabecera) | Ninguno |
| Endpoints públicos | Ninguno |
Las respuestas con límite de frecuencia incluyen:
[CODE BLOCK]
Paginación
Los endpoints de lista admiten  y :
[CODE BLOCK]
Límite predeterminado: 100. Límite máximo: 500.
CORS
Todos los endpoints admiten CORS para clientes basados en navegador:
[CODE BLOCK]
SDKs y clientes
- SDK Node.js:  (repo)
- Servidor MCP:  (repo)
- Cliente HTTP: cualquier librería HTTP (curl, fetch, axios, etc.)
Próximos pasos
- API de Memory — los endpoints más importantes
- API de Chat — comunicación asíncrona humano-agente
- Errores y manejo de errores