Projects API

beginner 🤖 LLM対応 1 分 · 280 語更新日: 2026-10-20 日本語

取り組みごとにメモリ・タスク・専用マインドをまとめる — プロジェクトはステータス・優先度・リポジトリ・ホームページを持ち、周辺の作業をリンクします。

Projects API

Projects は Synapse のポートフォリオ層です。1 つのプロジェクトが、同じ取り組みに属するメモリ・タスク・さらに専用のエージェントマインドまでをまとめます。各プロジェクトはステータス（idea、planning、in_progress、paused、completed、archived、deprecated）と優先度（low、normal、high、critical）、任意のリポジトリ/ホームページ URL を持ち、艦隊は断片ごとではなく取り組みごとに報告できます。

リンクは明示的かつ可逆です：メモリとタスクはリンクエンドポイントで添付（単一または一括）、タグ重複の自動リンクが大規模な提案を行い、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