# FAQ de la API
SUMMARY: Preguntas comunes sobre la API — autenticación, límites de frecuencia, manejo de errores, descubrimiento de endpoints.

FAQ de la API
Preguntas comunes sobre la API de Synapse.
¿Cómo me autentico?
Dos métodos:
1. Mind Key (para endpoints de datos): 
2. JWT (para endpoints de cuenta): 
O vía parámetro de consulta (límite de 60 req/min): 
Consulte Autenticación.
¿Cuál es la diferencia entre Mind Key y JWT?
- Mind Key: ámbito de tenant, nunca expira, para datos de memoria/chat/tareas
- JWT: ámbito de usuario, expira a los 7 días, para gestión de cuenta/mind
Consulte Mind Key vs JWT.
¿Por qué obtengo 401 Unauthorized?
Causas comunes:
1. Falta la cabecera 
2. Mind Key inválido (verifique que empieza por )
3. Uso de un JWT donde se requiere un Mind Key (o viceversa)
4. El Mind Key ha sido revocado
Solución: Verifique su token. Consulte Autenticación.
¿Por qué obtengo 404 Not Found?
Usó una ruta de endpoint incorrecta. Synapse solo tiene las rutas listadas en
.
Solución: Llame a  para ver todas las rutas válidas. No
adivine.
¿Por qué obtengo 429 Too Many Requests?
Está usando autenticación por parámetro de consulta , que está limitada a
60/min.
Solución: Cambie a la cabecera  (sin límite de
frecuencia).
Consulte Límites de frecuencia.
¿Cómo listo todos los endpoints?
[CODE BLOCK]
¿Cómo encuentro el endpoint correcto?
1. Consulte  para la lista legible por máquina
2. Consulte  para la documentación completa de la API
3. Explore  para el sistema de documentación
4. Use  para la especificación OpenAPI 3.0
¿Puedo usar GET en lugar de POST?
Algunos endpoints POST tienen equivalentes GET para herramientas que solo usan
URL:
-  ↔ 
-  ↔ 
-  ↔ 
Consulte  para ver las variantes GET disponibles.
¿Cómo manejo los errores?
Todos los errores devuelven JSON:
[CODE BLOCK]
Consulte Errores y manejo de errores.
¿Cuál es el límite del cuerpo de la solicitud?
10 MB. Para payloads más grandes (p. ej. subida de archivos), use los endpoints
multipart.
¿La API admite CORS?
Sí. Todos los endpoints devuelven:
[CODE BLOCK]
¿Hay un SDK?
Sí:
- Node.js: 
- MCP: 
Consulte Resumen de la API para más detalles.
¿Cómo pagino?
Use  y :
[CODE BLOCK]
Límite predeterminado: 100. Máximo: 500.
¿Puedo filtrar memorias por categoría o etiqueta?
Sí:
[CODE BLOCK]
¿Cómo busco memorias?
De dos formas:
1. Búsqueda por palabra clave FTS5: 
2. Búsqueda semántica: 
Consulte Búsqueda FTS5 y Búsqueda semántica.
¿Cómo actualizo una memoria?
POST  con la misma  +  — la memoria existente se
actualiza, no se duplica.
[CODE BLOCK]
¿Cómo elimino una memoria?
[CODE BLOCK]
¿Puedo eliminar en lote?
Sí:
[CODE BLOCK]
Próximos pasos
- Resumen de la API
- Errores y manejo de errores
- Autenticación