Projects API

beginner 🤖 LLM 친화적 2 분 · 353 단어 업데이트: 2026-10-20 한국어

이니셔티별로 메모리·태스크·전용 마인드를 묶습니다 — 프로젝트는 상태·우선순위·저장소·홈페이지를 가지며 관련 작업을 연결합니다.

Projects API

Projects는 Synapse의 포트폴리오 계층입니다. 하나의 프로젝트가 동일한 이니셔티에 속한 메모리·태스크·심지어 전용 에이전트 마인드까지 묶습니다. 각 프로젝트는 상태(idea, planning, in_progress, paused, completed, archived, deprecated), 우선순위(low, normal, high, critical), 선택적 저장소/홈페이지 URL을 가지므로 함대는 조각이 아니라 이니셔티 단위로 보고할 수 있습니다.

연결은 명시적이며 가역적입니다: 메모리와 태스크는 링크 엔드포인트로 붙고(단건 또는 bulk), 태그 겹침 자동 연결이 대량 제안을 하며, GET /memory/:id/projects가 역방향 질문에 답합니다. 프로젝트 마인드(GET /projects/shared-mind)는 모든 형제가 읽을 수 있는 이니셔티 전용 공유 메모리 공간을 줍니다.

프로젝트가 담는 것

메서드	경로	목적
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

빠른 시작

# 연결된 메모리 / 엔드포인트
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"

메모리·태스크 연결

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
연결된 메모리: 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