# Vue d'ensemble de l'API & URL de base
SUMMARY: Tous les endpoints de l'API Synapse, l'URL de base, les schémas d'authentification et les formats de réponse en un coup d'œil.

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.

Vue d'ensemble de l'API & URL de base
L'API Synapse est une API HTTP RESTful. Tous les endpoints renvoient du JSON (sauf
mention contraire). Cette page couvre l'essentiel à connaître avant d'explorer des
endpoints spécifiques.
URL de base
[CODE BLOCK]
Tous les chemins de cette documentation sont relatifs à cette URL de base. Pour les
instances auto-hébergées, remplacez par votre propre URL.
Authentification
Deux méthodes, toutes deux envoyées via l'en-tête  :
[CODE BLOCK]
Ou via un paramètre de requête (limité à 60/min) :
[CODE BLOCK]
Voir Authentification pour plus de détails.
Groupes d'endpoints
| Groupe | Auth | Description |
|-------|------|-------------|
| Public | Aucune | Page d'accueil, santé, OpenAPI, docs |
| Memory | Mind Key | CRUD, recherche, sync, embeddings |
| Chat | Mind Key / JWT | Messagerie asynchrone entre humain et agent |
| Tasks | Mind Key | Gestion des tâches |
| Scripts | Mind Key / JWT | Stockage persistant de scripts |
| Scheduler | Mind Key | Tâches cron + variables |
| Webhooks | Mind Key | Rappels HTTP sur événements |
| Computers | Mind Key / JWT | Contrôle à distance d'ordinateurs |
| User/Minds | JWT | Compte + gestion des minds |
| Sharing | JWT | Partage de minds entre utilisateurs |
| Push | JWT | Abonnements Web Push |
| Tools | Aucune | Heure, calculatrice, aléatoire (utilitaires publics) |
Formats de réponse
- JSON (par défaut) : 
- Texte brut :  renvoie du texte optimisé pour les LLM
- HTML : , , , , 
Enveloppe de réponse standard
Les réponses de succès renvoient directement les données :
[CODE BLOCK]
Les réponses d'erreur utilisent ce format :
[CODE BLOCK]
> [!NOTE]
> Le champ  renvoie vers la documentation pertinente pour les erreurs courantes.
Codes d'état HTTP
| Code | Signification |
|------|---------|
| 200 | Succès (GET, PUT) |
| 201 | Créé (POST) |
| 204 | Aucun contenu (DELETE) |
| 400 | Requête incorrecte (erreur de validation) |
| 401 | Non autorisé (jeton manquant/invalide) |
| 403 | Interdit (mauvais type de jeton) |
| 404 | Introuvable (le chemin n'existe pas) |
| 409 | Conflit (doublon) |
| 429 | Trop de requêtes (limite de débit) |
| 500 | Erreur serveur |
Endpoints de découvrabilité
| Endpoint | Rôle |
|----------|---------|
|  | Page d'accueil (optimisée LLM) |
|  | Liste lisible par machine de tous les endpoints |
|  | Liste d'endpoints en texte brut |
|  | Spécification OpenAPI 3.0 |
|  | Documentation complète de l'API (HTML) |
|  | Docs de l'API en JSON |
|  | Système de documentation (HTML) |
|  | Index de documentation (JSON) |
|  | Toutes les docs en un bloc de texte |
|  | Terrain de jeu interactif pour l'API |
Limites de débit
| Méthode d'auth | Limite |
|-------------|-------|
| Mind Key (en-tête) | Aucune |
| Mind Key (?key=) | 60/min par IP |
| JWT (en-tête) | Aucune |
| Endpoints publics | Aucune |
Les réponses soumises à limite de débit incluent :
[CODE BLOCK]
Pagination
Les endpoints de liste prennent en charge  et  :
[CODE BLOCK]
Limite par défaut : 100. Limite maximale : 500.
CORS
Tous les endpoints prennent en charge CORS pour les clients basés sur navigateur :
[CODE BLOCK]
SDK & Clients
- SDK Node.js :  (dépôt)
- Serveur MCP :  (dépôt)
- Client HTTP : n'importe quelle bibliothèque HTTP (curl, fetch, axios, etc.)
Prochaines étapes
- API Memory — les endpoints les plus importants
- API Chat — communication asynchrone humain-agent
- Erreurs & gestion des erreurs