{"title":"Scripts-API","slug":"scripts","category":"api","summary":"Persistenter Script-Speicher — wiederverwendbare Shell-, Python- oder Node-Scripts speichern und via curl | bash abrufen.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":125,"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":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Scripts-API\n\nDie Scripts-API bietet einen persistenten Speicher für wiederverwendbare Scripts.\nScripts werden benannt und innerhalb eines Minds versioniert und können als\nKlartext abgerufen werden — perfekt für `curl | bash`-Patterns.\n\n## Endpunkte\n\n### POST /script\n\nEin Script speichern oder aktualisieren.\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\nScript-Inhalt als `text/plain` abrufen. Perfekt für das Weiterleiten an 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\nScript-Metadaten ohne den Inhalt abrufen.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nAntwort:\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\nAlle Scripts im aktuellen Mind auflisten.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nEin Script löschen.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n     https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## Häufige Anwendungsfälle\n\n### Deploy-Scripts\n\nStandardisierte Deploy-Prozeduren speichern, damit das LLM sie ausführen kann,\nohne die Schritte jedes Mal neu abzuleiten:\n\n```bash\n# LLM stores this once\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# Later sessions just run it\ncurl -H \"Authorization: ...\" .../script/deploy-vps1 | bash\n```\n\n### Troubleshooting-Snippets\n\nDiagnose-Befehle für häufige Probleme speichern:\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### Konfigurationsgeneratoren\n\nScripts speichern, die Konfigurationen erzeugen:\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## Nächste Schritte\n\n- [Variables-API](/docs/api/variables)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"<h1>Scripts-API</h1>\n<p>Die Scripts-API bietet einen persistenten Speicher für wiederverwendbare Scripts.\nScripts werden benannt und innerhalb eines Minds versioniert und können als\nKlartext abgerufen werden — perfekt für <code>curl | bash</code>-Patterns.</p>\n<h2>Endpunkte</h2>\n<h3>POST /script</h3>\n<p>Ein Script speichern oder aktualisieren.</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>Script-Inhalt als <code>text/plain</code> abrufen. Perfekt für das Weiterleiten an 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>Script-Metadaten ohne den Inhalt abrufen.</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>Antwort:</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>Alle Scripts im aktuellen Mind auflisten.</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>Ein Script löschen.</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>Häufige Anwendungsfälle</h2>\n<h3>Deploy-Scripts</h3>\n<p>Standardisierte Deploy-Prozeduren speichern, damit das LLM sie ausführen kann,\nohne die Schritte jedes Mal neu abzuleiten:</p>\n<pre><code class=\"hljs language-bash\"><span class=\"hljs-comment\"># LLM stores this once</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\"># Later sessions just run it</span>\ncurl -H <span class=\"hljs-string\">&quot;Authorization: ...&quot;</span> .../script/deploy-vps1 | bash</code></pre><h3>Troubleshooting-Snippets</h3>\n<p>Diagnose-Befehle für häufige Probleme speichern:</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>Konfigurationsgeneratoren</h3>\n<p>Scripts speichern, die Konfigurationen erzeugen:</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>Nächste Schritte</h2>\n<ul>\n<li><a href=\"/docs/api/variables\">Variables-API</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"]}