# Projects API
SUMMARY: प्रत्येक पहल के लिए मेमोरी, टास्क और समर्पित माइंड्स को समूहित करें — प्रोजेक्ट में स्थिति, प्राथमिकता, रिपॉजिटरी और होमपेज होती है और उसका कार्य जुड़ा रहता है।

KEY CONTEXT:
प्रमाणीकरण: Mind Key (या user JWT)। सभी endpoints कॉलर के mind-scoped हैं।
सूची: GET /projects?status=in_progress&priority=critical
बनाएँ: POST /projects {name, status?, priority?, repository_url?}
आँकड़े: GET /projects/stats
विवरण: GET /projects/:id (memory + task counts सहित)
लिंक: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}
ऑटो-लिंक: POST /projects/:id/auto-link (टैग ओवरलैप से)
साझा माइंड: GET /projects/shared-mind (idempotent)

Projects API
Projects, Synapse की पोर्टफोलियो परत है: एक प्रोजेक्ट उन सभी memories, tasks और यहाँ तक कि समर्पित agent minds को बाँधता है जो एक ही पहल से जुड़े हैं। हर प्रोजेक्ट में स्थिति (idea, planning, inprogress, paused, completed, archived, deprecated), प्राथमिकता (low, normal, high, critical) और वैकल्पिक repository/homepage URLs होती हैं — इससे fleet टुकड़ों के बजाय पूरी पहल के अनुसार रिपोर्ट करती है।
लिंकिंग स्पष्ट और प्रतिवर्तनीय है: memories और tasks लिंक endpoints से जुड़ते हैं (एकल या bulk), टैग-ओवरलैप ऑटो-लिंक बड़े पैमाने पर सुझाव देता है, और GET /memory/:id/projects उल्टा प्रश्न हल करता है। प्रोजेक्ट माइंड (GET /projects/shared-mind) पहल को अपना साझा memory-space देता है जिसे हर सिबलिंग पढ़ सकता है।
प्रोजेक्ट में क्या होता है
| विधि | पथ | उद्देश्य |
| --- | --- | --- |
| POST |  | Create a project {name, slug?, description?, status?, priority?, repositoryurl?, homepageurl?, tags?, metadata?} |
| GET |  | List projects (filter: ?status=, ?priority=, ?tag=, ?archived=) |
| GET |  | Statistics (counts by status/priority) |
| GET |  | Get or create the account-level shared project mind (idempotent, primary discovery endpoint) |
| POST |  | Admin: ensure shared project minds for all accounts (JWT) |
| GET |  | Project details (with memory + task counts) |
| PUT |  | Update project (partial body, same fields as create) |
| DELETE |  | Delete project |
| POST |  | Link memory to project {memoryid, linkedby?} |
| POST |  | Link multiple memories {memoryids: [...]} |
| DELETE |  | Unlink memory from project |
| GET |  | List memories linked to project (?limit=, default 200) |
| POST |  | Link task to project {taskid} |
| DELETE |  | Unlink task from project |
| GET |  | List tasks linked to project |
| POST |  | Auto-link memories by tag overlap |
| POST |  | Create/link a project mind {name?} |
| GET |  | List project minds |
| DELETE |  | Remove a project mind link |
| GET |  | List projects linked to a memory |
त्वरित प्रारंभ
[CODE BLOCK]
Memories और tasks लिंक करना
-  {memoryid, linkedby?} · bulk:  {memoryids: [...]}
-  {taskid} ·  · 
- :  — इसके विपरीत: 
- उदाहरण:  (टैग ओवरलैप से मेमोरीज़ का ऑटो-लिंक)
प्रोजेक्ट माइंड्स
 (प्रतिक्रिया: mind, idempotent) ·  {name?} ·  ·