# API Overview और Base URL
SUMMARY: एक नज़र में सभी Synapse API एंडपॉइंट्स, base URL, प्रमाणीकरण पैटर्न, और प्रतिक्रिया प्रारूप।

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

API Overview और Base URL
Synapse API एक RESTful HTTP API है। सभी एंडपॉइंट्स JSON लौटाते हैं (जहाँ उल्लेख किया गया है वहाँ को छोड़कर)। यह पृष्ठ विशिष्ट एंडपॉइंट्स में गोता लगाने से पहले आवश्यक मूल बातें कवर करता है।
Base URL
[CODE BLOCK]
इस दस्तावेज़ीकरण के सभी पाथ इस base URL के सापेक्ष हैं। सेल्फ-होस्टेड इंस्टेंस के लिए, अपने स्वयं के URL से बदलें।
प्रमाणीकरण
दो विधियाँ, दोनों  हेडर के माध्यम से भेजी जाती हैं:
[CODE BLOCK]
या क्वेरी पैरामीटर के माध्यम से (60/min तक सीमित):
[CODE BLOCK]
विवरण के लिए प्रमाणीकरण देखें।
एंडपॉइंट समूह
| समूह | प्रमाणीकरण | विवरण |
|-------|------|-------------|
| Public | कोई नहीं | लैंडिंग पृष्ठ, स्वास्थ्य, OpenAPI, दस्तावेज़ |
| Memory | Mind Key | CRUD, खोज, सिंक, एम्बेडिंग |
| Chat | Mind Key / JWT | मानव और एजेंट के बीच अतुल्यकालिक मैसेजिंग |
| Tasks | Mind Key | कार्य प्रबंधन |
| Scripts | Mind Key / JWT | स्थायी स्क्रिप्ट स्टोर |
| Scheduler | Mind Key | Cron कार्य + वेरिएबल्स |
| Webhooks | Mind Key | घटनाओं पर HTTP कॉलबैक |
| Computers | Mind Key / JWT | रिमोट कंप्यूटर नियंत्रण |
| User/Minds | JWT | खाता + mind प्रबंधन |
| Sharing | JWT | उपयोगकर्ताओं के बीच mind साझाकरण |
| Push | JWT | Web Push सब्सक्रिप्शन |
| Tools | कोई नहीं | समय, calc, random (सार्वजनिक उपयोगिताएँ) |
प्रतिक्रिया प्रारूप
- JSON (डिफ़ॉल्ट): 
- सादा टेक्स्ट:  LLM-अनुकूलित टेक्स्ट लौटाता है
- HTML: , , , , 
मानक प्रतिक्रिया लिफ़ाफ़ा
सफलता प्रतिक्रियाएँ सीधे डेटा लौटाती हैं:
[CODE BLOCK]
त्रुटि प्रतिक्रियाएँ इस प्रारूप का उपयोग करती हैं:
[CODE BLOCK]
> [!NOTE]
>  फ़ील्ड सामान्य त्रुटियों के लिए प्रासंगिक दस्तावेज़ीकरण से लिंक करता है।
HTTP स्टेटस कोड
| कोड | अर्थ |
|------|---------|
| 200 | सफलता (GET, PUT) |
| 201 | बनाया गया (POST) |
| 204 | कोई सामग्री नहीं (DELETE) |
| 400 | खराब अनुरोध (सत्यापन त्रुटि) |
| 401 | अनधिकृत (गायब/अमान्य टोकन) |
| 403 | निषिद्ध (गलत टोकन प्रकार) |
| 404 | नहीं मिला (पाथ मौजूद नहीं है) |
| 409 | टकराव (डुप्लिकेट) |
| 429 | बहुत अधिक अनुरोध (रेट लिमिट) |
| 500 | सर्वर त्रुटि |
खोज क्षमता एंडपॉइंट्स
| एंडपॉइंट | उद्देश्य |
|----------|---------|
|  | लैंडिंग पृष्ठ (LLM-अनुकूलित) |
|  | सभी एंडपॉइंट्स की मशीन-पठनीय सूची |
|  | सादे-टेक्स्ट एंडपॉइंट सूची |
|  | OpenAPI 3.0 विशेषता |
|  | पूर्ण API दस्तावेज़ीकरण (HTML) |
|  | JSON के रूप में API दस्तावेज़ |
|  | दस्तावेज़ीकरण सिस्टम (HTML) |
|  | दस्तावेज़ीकरण सूचकांक (JSON) |
|  | सभी दस्तावेज़ एक टेक्स्ट ब्लॉक के रूप में |
|  | इंटरैक्टिव API प्लेग्राउंड |
रेट लिमिट
| प्रमाणीकरण विधि | सीमा |
|-------------|-------|
| Mind Key (हेडर) | कोई नहीं |
| Mind Key (?key=) | प्रति IP 60/min |
| JWT (हेडर) | कोई नहीं |
| सार्वजनिक एंडपॉइंट्स | कोई नहीं |
रेट-लिमिटेड प्रतिक्रियाएँ शामिल करती हैं:
[CODE BLOCK]
पेजिनेशन
सूची एंडपॉइंट्स  और  का समर्थन करते हैं:
[CODE BLOCK]
डिफ़ॉल्ट सीमा: 100। अधिकतम सीमा: 500।
CORS
सभी एंडपॉइंट्स ब्राउज़र-आधारित क्लाइंट्स के लिए CORS का समर्थन करते हैं:
[CODE BLOCK]
SDKs और क्लाइंट्स
- Node.js SDK:  (repo)
- MCP Server:  (repo)
- HTTP client: कोई भी HTTP लाइब्रेरी (curl, fetch, axios, आदि)
अगले कदम
- Memory API — सबसे महत्वपूर्ण एंडपॉइंट्स
- Chat API — अतुल्यकालिक मानव-एजेंट संचार
- त्रुटियाँ और त्रुटि प्रबंधन