{"title":"Scripts API","slug":"scripts","category":"api","summary":"Lưu trữ script cố định — lưu shell, Python, hoặc Node script tái sử dụng và lấy qua curl | bash.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":178,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Scripts API\n\nScripts API cung cấp lưu trữ cố định cho script tái sử dụng. Script được đặt tên\nvà đánh phiên bản trong một mind, có thể lấy dưới dạng văn bản thuần — hoàn hảo\ncho mẫu `curl | bash`.\n\n## Các endpoint\n\n### POST /script\n\nLưu hoặc cập nhật một 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\nLấy nội dung script dưới dạng `text/plain`. Hoàn hảo để pipe và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\nLấy metadata script mà không có nội dung.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nPhản hồi:\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\nLiệt kê tất cả script trong mind hiện tại.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nXóa một script.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## Trường hợp sử dụng phổ biến\n\n### Script triển khai\n\nLưu quy trình triển khai chuẩn để LLM có thể chạy mà không cần suy luận lại các\nbước mỗi lầ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### Đoạn mã khắc phục sự cố\n\nLưu các lệnh chẩn đoán cho các vấn đề phổ biế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### Trình tạo cấu hình\n\nLưu các script tạo cấu hình:\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## Bước tiếp theo\n\n- [Variables API](/docs/api/variables)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Scripts API

\n

Scripts API cung cấp lưu trữ cố định cho script tái sử dụng. Script được đặt tên\nvà đánh phiên bản trong một mind, có thể lấy dưới dạng văn bản thuần — hoàn hảo\ncho mẫu curl | bash.

\n

Các endpoint

\n

POST /script

\n

Lưu hoặc cập nhật một 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

Lấy nội dung script dưới dạng text/plain. Hoàn hảo để pipe vào bash.

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

GET /script/:name/info

\n

Lấy metadata script mà không có nội dung.

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

Phản hồi:

\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

Liệt kê tất cả script trong mind hiện tại.

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

DELETE /script/:name

\n

Xóa một script.

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

Trường hợp sử dụng phổ biến

\n

Script triển khai

\n

Lưu quy trình triển khai chuẩn để LLM có thể chạy mà không cần suy luận lại các\nbước mỗi lầ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

Đoạn mã khắc phục sự cố

\n

Lưu các lệnh chẩn đoán cho các vấn đề phổ biế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}'

Trình tạo cấu hình

\n

Lưu các script tạo cấu hình:

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

Bước tiếp theo

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