# Scripts API

Scripts API cung cấp lưu trữ cố định cho script tái sử dụng. Script được đặt tên
và đá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
cho mẫu `curl | bash`.

## Các endpoint

### POST /script

Lưu hoặc cập nhật một script.

```bash
curl -X POST https://synapse.schaefer.zone/script \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-synapse",
    "content": "#!/bin/bash\nset -euo pipefail\ngit pull\nnpm ci\nnpm run build\ndocker compose up -d",
    "description": "Deploy Synapse to production",
    "language": "bash"
  }'
```

### GET /script/:name

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

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

### GET /script/:name/info

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

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

Phản hồi:

```json
{
  "name": "deploy-synapse",
  "description": "Deploy Synapse to production",
  "language": "bash",
  "size_bytes": 142,
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}
```

### GET /scripts

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

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

### DELETE /script/:name

Xóa một script.

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

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

### Script triển khai

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
bước mỗi lần:

```bash
# LLM stores this once
curl -X POST .../script -d '{
  "name": "deploy-vps1",
  "content": "#!/bin/bash\nssh vps1 \"cd /opt/synapse && git pull && docker compose up -d --build\"",
  "language": "bash"
}'

# Later sessions just run it
curl -H "Authorization: ..." .../script/deploy-vps1 | bash
```

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

Lưu các lệnh chẩn đoán cho các vấn đề phổ biến:

```bash
curl -X POST .../script -d '{
  "name": "check-docker",
  "content": "#!/bin/bash\ndocker ps\ndocker stats --no-stream\ndocker system df",
  "description": "Quick Docker health check",
  "language": "bash"
}'
```

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

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

```bash
curl -X POST .../script -d '{
  "name": "gen-nginx-conf",
  "content": "#!/usr/bin/env python3\nimport sys\n# ... generate nginx config from template ...",
  "language": "python"
}'
```

## Bước tiếp theo

- [Variables API](/docs/api/variables)
- [Cron & Scheduler](/docs/api/cron)