{"title":"Variables API","slug":"variables","category":"api","summary":"LLM 상태를 위한 빠른 키-값 저장소 — 카운터, 플래그, 마지막 확인 타임스탬프, 부분 진행 상황.","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":161,"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":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# Variables API\n\nVariables API는 임시 상태를 위한 빠른 키-값 저장소입니다. (인덱싱되고,\n검색 가능하며 구조화된) 메모리와 달리 변수는 빠른 읽기/쓰기 액세스에\n최적화되어 있습니다 — 카운터, 플래그, 세션 상태에 적합합니다.\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## Variables와 Memory 사용 시기\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는 임시 상태를 위한 빠른 키-값 저장소입니다. (인덱싱되고,\n검색 가능하며 구조화된) 메모리와 달리 변수는 빠른 읽기/쓰기 액세스에\n최적화되어 있습니다 — 카운터, 플래그, 세션 상태에 적합합니다.

\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

Variables와 Memory 사용 시기

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