{"title":"API Scripts","slug":"scripts","category":"api","summary":"Stockage persistant de scripts — sauvegardez des scripts shell, Python ou Node réutilisables et récupérez-les via curl | bash.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":165,"read_minutes":1,"llm_context":"Auth: Mind Key or JWT\nStore: POST /script { name, content, description?, language? }\nFetch as text: GET /script/:name (returns text/plain, curl | bash ready)\nInfo: GET /script/:name/info (metadata without content)\nList: GET /scripts (JSON array)\nDelete: DELETE /script/:name\nUse case: store deployment scripts, config generators, troubleshooting snippets\n","lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# API Scripts\n\nL'API Scripts fournit un stockage persistant pour les scripts réutilisables. Les\nscripts sont nommés et versionnés dans un mind, et peuvent être récupérés en texte\nbrut — parfait pour les schémas `curl | bash`.\n\n## Endpoints\n\n### POST /script\n\nStocke ou met à jour un script.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/script \\\n  -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"deploy-synapse\",\n    \"content\": \"#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d\",\n    \"description\": \"Deploy Synapse to production\",\n    \"language\": \"bash\"\n  }'\n```\n\n### GET /script/:name\n\nRécupère le contenu du script en `text/plain`. Parfait pour le rediriger vers bash.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/script/deploy-synapse | bash\n```\n\n### GET /script/:name/info\n\nRécupère les métadonnées du script sans le contenu.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nRéponse :\n\n```json\n{\n  \"name\": \"deploy-synapse\",\n  \"description\": \"Deploy Synapse to production\",\n  \"language\": \"bash\",\n  \"size_bytes\": 142,\n  \"created_at\": \"2026-06-27T...\",\n  \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /scripts\n\nListe tous les scripts du mind courant.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nSupprime un script.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## Cas d'usage courants\n\n### Scripts de déploiement\n\nStockez les procédures de déploiement standard pour que le LLM puisse les exécuter\nsans avoir à re-dériver les étapes à chaque fois :\n\n```bash\n# Le LLM stocke ceci une fois\ncurl -X POST .../script -d '{\n  \"name\": \"deploy-vps1\",\n  \"content\": \"#!/bin/bash\\nssh vps1 \\\"cd /opt/synapse && git pull && docker compose up -d --build\\\"\",\n  \"language\": \"bash\"\n}'\n\n# Les sessions ultérieures se contentent de l'exécuter\ncurl -H \"Authorization: ...\" .../script/deploy-vps1 | bash\n```\n\n### Snippets de dépannage\n\nStockez des commandes de diagnostic pour les problèmes courants :\n\n```bash\ncurl -X POST .../script -d '{\n  \"name\": \"check-docker\",\n  \"content\": \"#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df\",\n  \"description\": \"Quick Docker health check\",\n  \"language\": \"bash\"\n}'\n```\n\n### Générateurs de configuration\n\nStockez des scripts qui génèrent des configurations :\n\n```bash\ncurl -X POST .../script -d '{\n  \"name\": \"gen-nginx-conf\",\n  \"content\": \"#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...\",\n  \"language\": \"python\"\n}'\n```\n\n## Prochaines étapes\n\n- [API Variables](/docs/api/variables)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"<h1>API Scripts</h1>\n<p>L&#39;API Scripts fournit un stockage persistant pour les scripts réutilisables. Les\nscripts sont nommés et versionnés dans un mind, et peuvent être récupérés en texte\nbrut — parfait pour les schémas <code>curl | bash</code>.</p>\n<h2>Endpoints</h2>\n<h3>POST /script</h3>\n<p>Stocke ou met à jour un script.</p>\n<pre><code class=\"hljs language-bash\">curl -X POST https://synapse.schaefer.zone/script \\\n  -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n  -H <span class=\"hljs-string\">&quot;Content-Type: application/json&quot;</span> \\\n  -d <span class=\"hljs-string\">&#x27;{\n    &quot;name&quot;: &quot;deploy-synapse&quot;,\n    &quot;content&quot;: &quot;#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d&quot;,\n    &quot;description&quot;: &quot;Deploy Synapse to production&quot;,\n    &quot;language&quot;: &quot;bash&quot;\n  }&#x27;</span></code></pre><h3>GET /script/:name</h3>\n<p>Récupère le contenu du script en <code>text/plain</code>. Parfait pour le rediriger vers bash.</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/script/deploy-synapse | bash</code></pre><h3>GET /script/:name/info</h3>\n<p>Récupère les métadonnées du script sans le contenu.</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info</code></pre><p>Réponse :</p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">&quot;name&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;deploy-synapse&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;description&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;Deploy Synapse to production&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;language&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;bash&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;size_bytes&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-number\">142</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;created_at&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;2026-06-27T...&quot;</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">&quot;updated_at&quot;</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-string\">&quot;2026-06-27T...&quot;</span>\n<span class=\"hljs-punctuation\">}</span></code></pre><h3>GET /scripts</h3>\n<p>Liste tous les scripts du mind courant.</p>\n<pre><code class=\"hljs language-bash\">curl -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/scripts</code></pre><h3>DELETE /script/:name</h3>\n<p>Supprime un script.</p>\n<pre><code class=\"hljs language-bash\">curl -X DELETE -H <span class=\"hljs-string\">&quot;Authorization: Bearer YOUR_MIND_KEY&quot;</span> \\\n     https://synapse.schaefer.zone/script/deploy-synapse</code></pre><h2>Cas d&#39;usage courants</h2>\n<h3>Scripts de déploiement</h3>\n<p>Stockez les procédures de déploiement standard pour que le LLM puisse les exécuter\nsans avoir à re-dériver les étapes à chaque fois :</p>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># Le LLM stocke ceci une fois</span>\ncurl -X POST .../script -d <span class=\"hljs-string\">&#x27;{\n  &quot;name&quot;: &quot;deploy-vps1&quot;,\n  &quot;content&quot;: &quot;#!/bin/bash\\nssh vps1 \\&quot;cd /opt/synapse &amp;&amp; git pull &amp;&amp; docker compose up -d --build\\&quot;&quot;,\n  &quot;language&quot;: &quot;bash&quot;\n}&#x27;</span>\n\n<span class=\"hljs-comment\"># Les sessions ultérieures se contentent de l&#x27;exécuter</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: ...&quot;</span> .../script/deploy-vps1 | bash</code></pre><h3>Snippets de dépannage</h3>\n<p>Stockez des commandes de diagnostic pour les problèmes courants :</p>\n<pre><code class=\"hljs language-bash\">curl -X POST .../script -d <span class=\"hljs-string\">&#x27;{\n  &quot;name&quot;: &quot;check-docker&quot;,\n  &quot;content&quot;: &quot;#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df&quot;,\n  &quot;description&quot;: &quot;Quick Docker health check&quot;,\n  &quot;language&quot;: &quot;bash&quot;\n}&#x27;</span></code></pre><h3>Générateurs de configuration</h3>\n<p>Stockez des scripts qui génèrent des configurations :</p>\n<pre><code class=\"hljs language-bash\">curl -X POST .../script -d <span class=\"hljs-string\">&#x27;{\n  &quot;name&quot;: &quot;gen-nginx-conf&quot;,\n  &quot;content&quot;: &quot;#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...&quot;,\n  &quot;language&quot;: &quot;python&quot;\n}&#x27;</span></code></pre><h2>Prochaines étapes</h2>\n<ul>\n<li><a href=\"/docs/api/variables\">API Variables</a></li>\n<li><a href=\"/docs/api/cron\">Cron &amp; Scheduler</a></li>\n</ul>\n","urls":{"html":"/docs/api/scripts","text":"/docs/api/scripts?format=text","json":"/docs/api/scripts?format=json","llm":"/docs/api/scripts?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}