{"title":"Scripts API","slug":"scripts","category":"api","summary":"영구 스크립트 저장소 — 재사용 가능한 shell, Python 또는 Node 스크립트를 저장하고 curl | bash로 가져옵니다.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":120,"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":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Scripts API\n\nScripts API는 재사용 가능한 스크립트를 위한 영구 저장소를 제공합니다.\n스크립트는 마인드 내에서 이름이 지정되고 버전 관리되며, 일반 텍스트로\n가져올 수 있습니다 — `curl | bash` 패턴에 적합합니다.\n\n## 엔드포인트\n\n### POST /script\n\n스크립트를 저장하거나 업데이트합니다.\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\n스크립트 내용을 `text/plain`으로 가져옵니다. 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\n내용 없이 스크립트 메타데이터를 가져옵니다.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\n응답:\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\n현재 마인드의 모든 스크립트를 나열합니다.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\n스크립트를 삭제합니다.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## 일반적인 사용 사례\n\n### 배포 스크립트\n\nLLM이 매번 단계를 다시 도출하지 않고도 실행할 수 있도록 표준 배포 절차를\n저장합니다:\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### 문제 해결 스니펫\n\n일반적인 문제에 대한 진단 명령을 저장합니다:\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### 구성 생성기\n\n구성을 생성하는 스크립트를 저장합니다:\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\n- [Variables API](/docs/api/variables)\n- [Cron 및 Scheduler](/docs/api/cron)\n","content_html":"

Scripts API

\n

Scripts API는 재사용 가능한 스크립트를 위한 영구 저장소를 제공합니다.\n스크립트는 마인드 내에서 이름이 지정되고 버전 관리되며, 일반 텍스트로\n가져올 수 있습니다 — curl | bash 패턴에 적합합니다.

\n

엔드포인트

\n

POST /script

\n

스크립트를 저장하거나 업데이트합니다.

\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

스크립트 내용을 text/plain으로 가져옵니다. bash로 파이프하기에 적합합니다.

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

GET /script/:name/info

\n

내용 없이 스크립트 메타데이터를 가져옵니다.

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

응답:

\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

현재 마인드의 모든 스크립트를 나열합니다.

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

DELETE /script/:name

\n

스크립트를 삭제합니다.

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

일반적인 사용 사례

\n

배포 스크립트

\n

LLM이 매번 단계를 다시 도출하지 않고도 실행할 수 있도록 표준 배포 절차를\n저장합니다:

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

구성 생성기

\n

구성을 생성하는 스크립트를 저장합니다:

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

다음 단계

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