# Scripts API

Scripts API पुनः प्रयोज्य स्क्रिप्ट्स के लिए एक स्थायी स्टोर प्रदान करता है। स्क्रिप्ट्स को एक mind के भीतर नामित और संस्करणित किया जाता है, और सादे टेक्स्ट के रूप में प्राप्त किया जा सकता है — `curl | bash` पैटर्न के लिए आदर्श।

## एंडपॉइंट्स

### POST /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

स्क्रिप्ट सामग्री को `text/plain` के रूप में प्राप्त करें। bash में पाइप करने के लिए आदर्श।

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

### GET /script/:name/info

सामग्री के बिना स्क्रिप्ट मेटाडेटा प्राप्त करें।

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

प्रतिक्रिया:

```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

वर्तमान mind में सभी स्क्रिप्ट्स की सूची बनाएँ।

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

### DELETE /script/:name

स्क्रिप्ट हटाएँ।

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

## सामान्य उपयोग के मामले

### परिनियोजन स्क्रिप्ट्स

मानक परिनियोजन प्रक्रियाएँ स्टोर करें ताकि LLM बिना हर बार चरणों को पुनः प्राप्त किए उन्हें चला सके:

```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
```

### ट्रबलशूटिंग स्निपेट्स

सामान्य समस्याओं के लिए नैदानिक कमांड स्टोर करें:

```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"
}'
```

### कॉन्फ़िगरेशन जनरेटर

कॉन्फ़िग जनरेट करने वाली स्क्रिप्ट्स स्टोर करें:

```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"
}'
```

## अगले कदम

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