# Variables API

Variables API क्षणिक स्थिति के लिए एक तीव्र key-value स्टोर है। मेमोरीज़ (जो अनुक्रमित, खोज योग्य, और संरचित हैं) के विपरीत, वेरिएबल्स त्वरित पढ़ने/लिखने के एक्सेस के लिए अनुकूलित हैं — काउंटर, फ़्लैग्स, और सत्र स्थिति के लिए आदर्श।

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

### POST /var

वेरिएबल सेट करें या अपडेट करें।

```bash
curl -X POST https://synapse.schaefer.zone/var \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "last_session_at", "value": "2026-06-27T14:00:00Z"}'
```

### GET /var/:key

एकल वेरिएबल प्राप्त करें।

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

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

```json
{ "key": "last_session_at", "value": "2026-06-27T14:00:00Z", "updated_at": "..." }
```

### GET /var

सभी वेरिएबल्स की सूची बनाएँ।

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

### DELETE /var/:key

वेरिएबल हटाएँ।

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

## वेरिएबल्स कब उपयोग करें बनाम मेमोरी

| उपयोग का मामला | उपयोग करें |
|----------|-----|
| उपयोगकर्ता नाम, प्राथमिकताएँ | Memory (खोज योग्य, संरचित) |
| अंतिम सत्र टाइमस्टैम्प | Variable (क्षणिक स्थिति) |
| काउंटर (जैसे भेजे गए संदेश) | Variable (अक्सर अपडेट) |
| वर्कफ़्लो स्थिति ("5 में से 3 चरण पूर्ण") | Variable (क्षणिक) |
| लंबी-प्रपत्र परियोजना नोट्स | Memory (फुल-टेक्स्ट अनुक्रमित) |
| पुनः प्रयोज्य स्क्रिप्ट्स | Script store (नामित, संस्करणित) |

## सामान्य पैटर्न

### अंतिम सत्र ट्रैक करें

```bash
# At session end
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# At session start
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)
```

### काउंटर पैटर्न

```bash
# Increment
N=$(curl .../var/api_calls | jq -r .value)
curl -X POST .../var -d "{\"key\": \"api_calls\", \"value\": $((N+1))}"
```

### फ़ीचर फ़्लैग्स

```bash
curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'

# Check
ENABLED=$(curl .../var/feature_x_enabled | jq -r .value)
if [ "$ENABLED" = "true" ]; then ... fi
```

## अगले कदम

- [Memory API](/docs/api/memory) — संरचित, खोज योग्य डेटा के लिए
- [Cron और Scheduler](/docs/api/cron)