API Scripts

L'API Scripts fournit un stockage persistant pour les scripts réutilisables. Les scripts sont nommés et versionnés dans un mind, et peuvent être récupérés en texte brut — parfait pour les schémas curl | bash.

Endpoints

POST /script

Stocke ou met à jour un script.

curl -X POST https://synapse.schaefer.zone/script \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-synapse",
    "content": "#!/bin/bash\nset -euo pipefail\ngit pull\nnpm ci\nnpm run build\ndocker compose up -d",
    "description": "Deploy Synapse to production",
    "language": "bash"
  }'

GET /script/:name

Récupère le contenu du script en text/plain. Parfait pour le rediriger vers bash.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

Récupère les métadonnées du script sans le contenu.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse/info

Réponse :

{
  "name": "deploy-synapse",
  "description": "Deploy Synapse to production",
  "language": "bash",
  "size_bytes": 142,
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}

GET /scripts

Liste tous les scripts du mind courant.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/scripts

DELETE /script/:name

Supprime un script.

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse

Cas d'usage courants

Scripts de déploiement

Stockez les procédures de déploiement standard pour que le LLM puisse les exécuter sans avoir à re-dériver les étapes à chaque fois :

# Le LLM stocke ceci une fois
curl -X POST .../script -d '{
  "name": "deploy-vps1",
  "content": "#!/bin/bash\nssh vps1 \"cd /opt/synapse && git pull && docker compose up -d --build\"",
  "language": "bash"
}'

# Les sessions ultérieures se contentent de l'exécuter
curl -H "Authorization: ..." .../script/deploy-vps1 | bash

Snippets de dépannage

Stockez des commandes de diagnostic pour les problèmes courants :

curl -X POST .../script -d '{
  "name": "check-docker",
  "content": "#!/bin/bash\ndocker ps\ndocker stats --no-stream\ndocker system df",
  "description": "Quick Docker health check",
  "language": "bash"
}'

Générateurs de configuration

Stockez des scripts qui génèrent des configurations :

curl -X POST .../script -d '{
  "name": "gen-nginx-conf",
  "content": "#!/usr/bin/env python3\nimport sys\n# ... generate nginx config from template ...",
  "language": "python"
}'

Prochaines étapes

• API Variables
• Cron & Scheduler