{"title":"API de Scripts","slug":"scripts","category":"api","summary":"Armazenamento persistente de scripts — salve scripts shell, Python ou Node reutilizáveis e os obtenha via curl | bash.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":153,"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":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# API de Scripts\n\nA API de Scripts oferece um armazenamento persistente para scripts reutilizáveis.\nScripts são nomeados e versionados dentro de um mind, e podem ser obtidos como\ntexto puro — perfeitos para padrões `curl | bash`.\n\n## Endpoints\n\n### POST /script\n\nArmazena ou atualiza um 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\nObtém o conteúdo do script como `text/plain`. Perfeito para pipe para o 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\nObtém metadados do script sem o conteúdo.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nResposta:\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\nLista todos os scripts no mind atual.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nExclui um script.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## Casos de uso comuns\n\n### Scripts de deploy\n\nArmazene procedimentos padrão de deploy para que o LLM possa executá-los sem\nrederivar os passos a cada vez:\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### Snippets de troubleshooting\n\nArmazene comandos de diagnóstico para problemas comuns:\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### Geradores de configuração\n\nArmazene scripts que geram configurações:\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## Próximos passos\n\n- [API de Variáveis](/docs/api/variables)\n- [Cron & Agendador](/docs/api/cron)\n","content_html":"

API de Scripts

\n

A API de Scripts oferece um armazenamento persistente para scripts reutilizáveis.\nScripts são nomeados e versionados dentro de um mind, e podem ser obtidos como\ntexto puro — perfeitos para padrões curl | bash.

\n

Endpoints

\n

POST /script

\n

Armazena ou atualiza um script.

\n
curl -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  }'

GET /script/:name

\n

Obtém o conteúdo do script como text/plain. Perfeito para pipe para o bash.

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

GET /script/:name/info

\n

Obtém metadados do script sem o conteúdo.

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

Resposta:

\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}

GET /scripts

\n

Lista todos os scripts no mind atual.

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

DELETE /script/:name

\n

Exclui um script.

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

Casos de uso comuns

\n

Scripts de deploy

\n

Armazene procedimentos padrão de deploy para que o LLM possa executá-los sem\nrederivar os passos a cada vez:

\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

Snippets de troubleshooting

\n

Armazene comandos de diagnóstico para problemas comuns:

\n
curl -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}'

Geradores de configuração

\n

Armazene scripts que geram configurações:

\n
curl -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}'

Próximos passos

\n\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"]}