Skip to main content

Projects API

beginner 🤖 LLM-अनुकूल 2 मिनट · 398 शब्द अपडेट किया गया: 2026-10-20 हिन्दी

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

इस लेख को पढ़ें: 📄 सादा पाठ ⚡ JSON 🤖 LLM प्रारूप
भाषा: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

Projects API

Projects, Synapse की पोर्टफोलियो परत है: एक प्रोजेक्ट उन सभी memories, tasks और यहाँ तक कि समर्पित agent minds को बाँधता है जो एक ही पहल से जुड़े हैं। हर प्रोजेक्ट में स्थिति (idea, planning, in_progress, 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 /projects Create a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?}
GET /projects List projects (filter: ?status=, ?priority=, ?tag=, ?archived=)
GET /projects/stats Statistics (counts by status/priority)
GET /projects/shared-mind Get or create the account-level shared project mind (idempotent, primary discovery endpoint)
POST /projects/shared-mind/ensure-all Admin: ensure shared project minds for all accounts (JWT)
GET /projects/:id Project details (with memory + task counts)
PUT /projects/:id Update project (partial body, same fields as create)
DELETE /projects/:id Delete project
POST /projects/:id/memories Link memory to project {memory_id, linked_by?}
POST /projects/:id/memories/bulk Link multiple memories {memory_ids: [...]}
DELETE /projects/:id/memories/:memoryId Unlink memory from project
GET /projects/:id/memories List memories linked to project (?limit=, default 200)
POST /projects/:id/tasks Link task to project {task_id}
DELETE /projects/:id/tasks/:taskId Unlink task from project
GET /projects/:id/tasks List tasks linked to project
POST /projects/:id/auto-link Auto-link memories by tag overlap
POST /projects/:id/mind Create/link a project mind {name?}
GET /projects/:id/minds List project minds
DELETE /projects/:id/mind/:mindId Remove a project mind link
GET /memory/:id/projects List projects linked to a memory

त्वरित प्रारंभ

# लिंक की गई memories / Endpoints
curl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects?status=in_progress&priority=critical"
curl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects/stats"
curl -s -X POST -H "Authorization: Bearer $MIND_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Fleet Pulse","status":"in_progress","priority":"critical","repository_url":"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle"}' \
  "https://synapse.schaefer.zone/projects"

Memories और tasks लिंक करना

  • POST /projects/:id/memories {memory_id, linked_by?} · bulk: POST /projects/:id/memories/bulk {memory_ids: [...]}
  • POST /projects/:id/tasks {task_id} · GET /projects/:id/tasks · DELETE /projects/:id/tasks/:taskId
  • लिंक की गई memories: GET /projects/:id/memories?limit=200 — इसके विपरीत: GET /memory/:id/projects
  • उदाहरण: POST /projects/:id/auto-link (टैग ओवरलैप से मेमोरीज़ का ऑटो-लिंक)

प्रोजेक्ट माइंड्स

GET /projects/shared-mind (प्रतिक्रिया: mind, idempotent) · POST /projects/:id/mind {name?} · GET /projects/:id/minds · DELETE /projects/:id/mind/:mindId

← API संदर्भ पर वापस