{"title":"Variables API","slug":"variables","category":"api","summary":"LLM स्थिति के लिए तीव्र key-value स्टोर — काउंटर, फ़्लैग्स, अंतिम-देखा टाइमस्टैम्प्स, आंशिक प्रगति।","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":187,"read_minutes":1,"llm_context":"Auth: Mind Key\nSet: POST /var { key, value }\nGet: GET /var/:key\nList: GET /var\nDelete: DELETE /var/:key\nUse case: store last-seen timestamps, counters, flags, partial workflow state\nFaster than memory (PostgreSQL direct, no FTS5 indexing)\nNot for: structured facts (use /memory), long content (use /script)\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# Variables API\n\nVariables API क्षणिक स्थिति के लिए एक तीव्र key-value स्टोर है। मेमोरीज़ (जो अनुक्रमित, खोज योग्य, और संरचित हैं) के विपरीत, वेरिएबल्स त्वरित पढ़ने/लिखने के एक्सेस के लिए अनुकूलित हैं — काउंटर, फ़्लैग्स, और सत्र स्थिति के लिए आदर्श।\n\n## एंडपॉइंट्स\n\n### POST /var\n\nवेरिएबल सेट करें या अपडेट करें।\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/var \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\"}'\n```\n\n### GET /var/:key\n\nएकल वेरिएबल प्राप्त करें।\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\nप्रतिक्रिया:\n\n```json\n{ \"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\", \"updated_at\": \"...\" }\n```\n\n### GET /var\n\nसभी वेरिएबल्स की सूची बनाएँ।\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var\n```\n\n### DELETE /var/:key\n\nवेरिएबल हटाएँ।\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\n## वेरिएबल्स कब उपयोग करें बनाम मेमोरी\n\n| उपयोग का मामला | उपयोग करें |\n|----------|-----|\n| उपयोगकर्ता नाम, प्राथमिकताएँ | Memory (खोज योग्य, संरचित) |\n| अंतिम सत्र टाइमस्टैम्प | Variable (क्षणिक स्थिति) |\n| काउंटर (जैसे भेजे गए संदेश) | Variable (अक्सर अपडेट) |\n| वर्कफ़्लो स्थिति (\"5 में से 3 चरण पूर्ण\") | Variable (क्षणिक) |\n| लंबी-प्रपत्र परियोजना नोट्स | Memory (फुल-टेक्स्ट अनुक्रमित) |\n| पुनः प्रयोज्य स्क्रिप्ट्स | Script store (नामित, संस्करणित) |\n\n## सामान्य पैटर्न\n\n### अंतिम सत्र ट्रैक करें\n\n```bash\n# At session end\ncurl -X POST .../var -d '{\"key\": \"last_session_at\", \"value\": \"'$(date -Iseconds)'\"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d \"$LAST\" +%s)\n```\n\n### काउंटर पैटर्न\n\n```bash\n# Increment\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"api_calls\\\", \\\"value\\\": $((N+1))}\"\n```\n\n### फ़ीचर फ़्लैग्स\n\n```bash\ncurl -X POST .../var -d '{\"key\": \"feature_x_enabled\", \"value\": \"true\"}'\n\n# Check\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ \"$ENABLED\" = \"true\" ]; then ... fi\n```\n\n## अगले कदम\n\n- [Memory API](/docs/api/memory) — संरचित, खोज योग्य डेटा के लिए\n- [Cron और Scheduler](/docs/api/cron)\n","content_html":"

Variables API

\n

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

\n

एंडपॉइंट्स

\n

POST /var

\n

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

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

GET /var/:key

\n

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

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

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

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

GET /var

\n

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

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

DELETE /var/:key

\n

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

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

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

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

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

\n

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

\n
# At session end\ncurl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d "$LAST" +%s)

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

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

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

\n
curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'\n\n# Check\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ "$ENABLED" = "true" ]; then ... fi

अगले कदम

\n\n","urls":{"html":"/docs/api/variables","text":"/docs/api/variables?format=text","json":"/docs/api/variables?format=json","llm":"/docs/api/variables?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}