{"title":"API Projects","slug":"projects","category":"api","summary":"Nhóm ký ức, nhiệm vụ và mind chuyên trách theo sáng kiến — dự án mang trạng thái, mức ưu tiên, repository và trang chủ, gắn kết công việc xung quanh.","audience":["human","llm"],"tags":["api","projects","tổ chức","portfolio"],"difficulty":"beginner","updated":"2026-10-20","word_count":420,"read_minutes":2,"llm_context":"Xác thực: Mind Key (hoặc JWT người dùng). Mọi endpoint đều scoped theo mind gọi.\nDanh sách: GET /projects?status=in_progress&priority=critical\nTạo: POST /projects {name, status?, priority?, repository_url?}\nThống kê: GET /projects/stats\nChi tiết: GET /projects/:id (kèm số memory + task)\nLiên kết: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}\nTự liên kết: POST /projects/:id/auto-link (theo trùng tag)\nMind chung: GET /projects/shared-mind (idempotent)\n","lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# API Projects\n\nProjects là tầng danh mục của Synapse: một dự án gom các ký ức, nhiệm vụ và thậm chí các mind chuyên trách của agent thuộc cùng một sáng kiến. Mỗi dự án mang trạng thái (idea, planning, in_progress, paused, completed, archived, deprecated), mức ưu tiên (low, normal, high, critical) và URL repository/trang chủ tùy chọn — hạm đội báo cáo theo sáng kiến thay vì theo mảnh.\n\nLiên kết rõ ràng và đảo ngược được: ký ức và nhiệm vụ gắn qua endpoint liên kết (đơn hoặc bulk), tự liên kết theo trùng tag đề xuất hàng loạt, và GET /memory/:id/projects trả lời câu hỏi ngược. Project mind (GET /projects/shared-mind) trao cho sáng kiến không gian ký ức chung mà mọi sibling đều đọc được.\n\n## Dự án chứa gì\n\n| Phương thức | Đường dẫn | Mục đích |\n| --- | --- | --- |\n| POST | `/projects` | Create a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?} |\n| GET | `/projects` | List projects (filter: ?status=, ?priority=, ?tag=, ?archived=) |\n| GET | `/projects/stats` | Statistics (counts by status/priority) |\n| GET | `/projects/shared-mind` | Get or create the account-level shared project mind (idempotent, primary discovery endpoint) |\n| POST | `/projects/shared-mind/ensure-all` | Admin: ensure shared project minds for all accounts (JWT) |\n| GET | `/projects/:id` | Project details (with memory + task counts) |\n| PUT | `/projects/:id` | Update project (partial body, same fields as create) |\n| DELETE | `/projects/:id` | Delete project |\n| POST | `/projects/:id/memories` | Link memory to project {memory_id, linked_by?} |\n| POST | `/projects/:id/memories/bulk` | Link multiple memories {memory_ids: [...]} |\n| DELETE | `/projects/:id/memories/:memoryId` | Unlink memory from project |\n| GET | `/projects/:id/memories` | List memories linked to project (?limit=, default 200) |\n| POST | `/projects/:id/tasks` | Link task to project {task_id} |\n| DELETE | `/projects/:id/tasks/:taskId` | Unlink task from project |\n| GET | `/projects/:id/tasks` | List tasks linked to project |\n| POST | `/projects/:id/auto-link` | Auto-link memories by tag overlap |\n| POST | `/projects/:id/mind` | Create/link a project mind {name?} |\n| GET | `/projects/:id/minds` | List project minds |\n| DELETE | `/projects/:id/mind/:mindId` | Remove a project mind link |\n| GET | `/memory/:id/projects` | List projects linked to a memory |\n\n## Bắt đầu nhanh\n\n```bash\n# Ký ức đã liên kết / Endpoint\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \"https://synapse.schaefer.zone/projects?status=in_progress&priority=critical\"\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \"https://synapse.schaefer.zone/projects/stats\"\ncurl -s -X POST -H \"Authorization: Bearer $MIND_KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Fleet Pulse\",\"status\":\"in_progress\",\"priority\":\"critical\",\"repository_url\":\"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle\"}' \\\n \"https://synapse.schaefer.zone/projects\"\n```\n\n## Liên kết ký ức và nhiệm vụ\n\n- `POST /projects/:id/memories` {memory_id, linked_by?} · bulk: `POST /projects/:id/memories/bulk` {memory_ids: [...]}\n- `POST /projects/:id/tasks` {task_id} · `GET /projects/:id/tasks` · `DELETE /projects/:id/tasks/:taskId`\n- `Ký ức đã liên kết`: `GET /projects/:id/memories?limit=200` — ngược lại: `GET /memory/:id/projects`\n- Ví dụ: `POST /projects/:id/auto-link` (tự liên kết memories theo trùng tag)\n\n## Mind dự án\n\n`GET /projects/shared-mind` (phản hồi: mind, idempotent) · `POST /projects/:id/mind` {name?} · `GET /projects/:id/minds` · `DELETE /projects/:id/mind/:mindId`\n","content_html":"

API Projects

\n

Projects là tầng danh mục của Synapse: một dự án gom các ký ức, nhiệm vụ và thậm chí các mind chuyên trách của agent thuộc cùng một sáng kiến. Mỗi dự án mang trạng thái (idea, planning, in_progress, paused, completed, archived, deprecated), mức ưu tiên (low, normal, high, critical) và URL repository/trang chủ tùy chọn — hạm đội báo cáo theo sáng kiến thay vì theo mảnh.

\n

Liên kết rõ ràng và đảo ngược được: ký ức và nhiệm vụ gắn qua endpoint liên kết (đơn hoặc bulk), tự liên kết theo trùng tag đề xuất hàng loạt, và GET /memory/:id/projects trả lời câu hỏi ngược. Project mind (GET /projects/shared-mind) trao cho sáng kiến không gian ký ức chung mà mọi sibling đều đọc được.

\n

Dự án chứa gì

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Phương thứcĐường dẫnMục đích
POST/projectsCreate a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?}
GET/projectsList projects (filter: ?status=, ?priority=, ?tag=, ?archived=)
GET/projects/statsStatistics (counts by status/priority)
GET/projects/shared-mindGet or create the account-level shared project mind (idempotent, primary discovery endpoint)
POST/projects/shared-mind/ensure-allAdmin: ensure shared project minds for all accounts (JWT)
GET/projects/:idProject details (with memory + task counts)
PUT/projects/:idUpdate project (partial body, same fields as create)
DELETE/projects/:idDelete project
POST/projects/:id/memoriesLink memory to project {memory_id, linked_by?}
POST/projects/:id/memories/bulkLink multiple memories {memory_ids: [...]}
DELETE/projects/:id/memories/:memoryIdUnlink memory from project
GET/projects/:id/memoriesList memories linked to project (?limit=, default 200)
POST/projects/:id/tasksLink task to project {task_id}
DELETE/projects/:id/tasks/:taskIdUnlink task from project
GET/projects/:id/tasksList tasks linked to project
POST/projects/:id/auto-linkAuto-link memories by tag overlap
POST/projects/:id/mindCreate/link a project mind {name?}
GET/projects/:id/mindsList project minds
DELETE/projects/:id/mind/:mindIdRemove a project mind link
GET/memory/:id/projectsList projects linked to a memory
\n

Bắt đầu nhanh

\n
# Ký ức đã liên kết / Endpoint\ncurl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects?status=in_progress&priority=critical"\ncurl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects/stats"\ncurl -s -X POST -H "Authorization: Bearer $MIND_KEY" -H "Content-Type: application/json" \\\n  -d '{"name":"Fleet Pulse","status":"in_progress","priority":"critical","repository_url":"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle"}' \\\n  "https://synapse.schaefer.zone/projects"

Liên kết ký ức và nhiệm vụ

\n\n

Mind dự án

\n

GET /projects/shared-mind (phản hồi: mind, idempotent) · POST /projects/:id/mind {name?} · GET /projects/:id/minds · DELETE /projects/:id/mind/:mindId

\n","urls":{"html":"/docs/api/projects","text":"/docs/api/projects?format=text","json":"/docs/api/projects?format=json","llm":"/docs/api/projects?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":420,"readMinutes":2,"llmContext":"Xác thực: Mind Key (hoặc JWT người dùng). Mọi endpoint đều scoped theo mind gọi.\nDanh sách: GET /projects?status=in_progress&priority=critical\nTạo: POST /projects {name, status?, priority?, repository_url?}\nThống kê: GET /projects/stats\nChi tiết: GET /projects/:id (kèm số memory + task)\nLiên kết: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}\nTự liên kết: POST /projects/:id/auto-link (theo trùng tag)\nMind chung: GET /projects/shared-mind (idempotent)\n","requestedLang":"vi","contentMarkdown":"\n# API Projects\n\nProjects là tầng danh mục của Synapse: một dự án gom các ký ức, nhiệm vụ và thậm chí các mind chuyên trách của agent thuộc cùng một sáng kiến. Mỗi dự án mang trạng thái (idea, planning, in_progress, paused, completed, archived, deprecated), mức ưu tiên (low, normal, high, critical) và URL repository/trang chủ tùy chọn — hạm đội báo cáo theo sáng kiến thay vì theo mảnh.\n\nLiên kết rõ ràng và đảo ngược được: ký ức và nhiệm vụ gắn qua endpoint liên kết (đơn hoặc bulk), tự liên kết theo trùng tag đề xuất hàng loạt, và GET /memory/:id/projects trả lời câu hỏi ngược. Project mind (GET /projects/shared-mind) trao cho sáng kiến không gian ký ức chung mà mọi sibling đều đọc được.\n\n## Dự án chứa gì\n\n| Phương thức | Đường dẫn | Mục đích |\n| --- | --- | --- |\n| POST | `/projects` | Create a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?} |\n| GET | `/projects` | List projects (filter: ?status=, ?priority=, ?tag=, ?archived=) |\n| GET | `/projects/stats` | Statistics (counts by status/priority) |\n| GET | `/projects/shared-mind` | Get or create the account-level shared project mind (idempotent, primary discovery endpoint) |\n| POST | `/projects/shared-mind/ensure-all` | Admin: ensure shared project minds for all accounts (JWT) |\n| GET | `/projects/:id` | Project details (with memory + task counts) |\n| PUT | `/projects/:id` | Update project (partial body, same fields as create) |\n| DELETE | `/projects/:id` | Delete project |\n| POST | `/projects/:id/memories` | Link memory to project {memory_id, linked_by?} |\n| POST | `/projects/:id/memories/bulk` | Link multiple memories {memory_ids: [...]} |\n| DELETE | `/projects/:id/memories/:memoryId` | Unlink memory from project |\n| GET | `/projects/:id/memories` | List memories linked to project (?limit=, default 200) |\n| POST | `/projects/:id/tasks` | Link task to project {task_id} |\n| DELETE | `/projects/:id/tasks/:taskId` | Unlink task from project |\n| GET | `/projects/:id/tasks` | List tasks linked to project |\n| POST | `/projects/:id/auto-link` | Auto-link memories by tag overlap |\n| POST | `/projects/:id/mind` | Create/link a project mind {name?} |\n| GET | `/projects/:id/minds` | List project minds |\n| DELETE | `/projects/:id/mind/:mindId` | Remove a project mind link |\n| GET | `/memory/:id/projects` | List projects linked to a memory |\n\n## Bắt đầu nhanh\n\n```bash\n# Ký ức đã liên kết / Endpoint\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \"https://synapse.schaefer.zone/projects?status=in_progress&priority=critical\"\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \"https://synapse.schaefer.zone/projects/stats\"\ncurl -s -X POST -H \"Authorization: Bearer $MIND_KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Fleet Pulse\",\"status\":\"in_progress\",\"priority\":\"critical\",\"repository_url\":\"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle\"}' \\\n \"https://synapse.schaefer.zone/projects\"\n```\n\n## Liên kết ký ức và nhiệm vụ\n\n- `POST /projects/:id/memories` {memory_id, linked_by?} · bulk: `POST /projects/:id/memories/bulk` {memory_ids: [...]}\n- `POST /projects/:id/tasks` {task_id} · `GET /projects/:id/tasks` · `DELETE /projects/:id/tasks/:taskId`\n- `Ký ức đã liên kết`: `GET /projects/:id/memories?limit=200` — ngược lại: `GET /memory/:id/projects`\n- Ví dụ: `POST /projects/:id/auto-link` (tự liên kết memories theo trùng tag)\n\n## Mind dự án\n\n`GET /projects/shared-mind` (phản hồi: mind, idempotent) · `POST /projects/:id/mind` {name?} · `GET /projects/:id/minds` · `DELETE /projects/:id/mind/:mindId`\n","contentHtml":"

API Projects

\n

Projects là tầng danh mục của Synapse: một dự án gom các ký ức, nhiệm vụ và thậm chí các mind chuyên trách của agent thuộc cùng một sáng kiến. Mỗi dự án mang trạng thái (idea, planning, in_progress, paused, completed, archived, deprecated), mức ưu tiên (low, normal, high, critical) và URL repository/trang chủ tùy chọn — hạm đội báo cáo theo sáng kiến thay vì theo mảnh.

\n

Liên kết rõ ràng và đảo ngược được: ký ức và nhiệm vụ gắn qua endpoint liên kết (đơn hoặc bulk), tự liên kết theo trùng tag đề xuất hàng loạt, và GET /memory/:id/projects trả lời câu hỏi ngược. Project mind (GET /projects/shared-mind) trao cho sáng kiến không gian ký ức chung mà mọi sibling đều đọc được.

\n

Dự án chứa gì

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Phương thứcĐường dẫnMục đích
POST/projectsCreate a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?}
GET/projectsList projects (filter: ?status=, ?priority=, ?tag=, ?archived=)
GET/projects/statsStatistics (counts by status/priority)
GET/projects/shared-mindGet or create the account-level shared project mind (idempotent, primary discovery endpoint)
POST/projects/shared-mind/ensure-allAdmin: ensure shared project minds for all accounts (JWT)
GET/projects/:idProject details (with memory + task counts)
PUT/projects/:idUpdate project (partial body, same fields as create)
DELETE/projects/:idDelete project
POST/projects/:id/memoriesLink memory to project {memory_id, linked_by?}
POST/projects/:id/memories/bulkLink multiple memories {memory_ids: [...]}
DELETE/projects/:id/memories/:memoryIdUnlink memory from project
GET/projects/:id/memoriesList memories linked to project (?limit=, default 200)
POST/projects/:id/tasksLink task to project {task_id}
DELETE/projects/:id/tasks/:taskIdUnlink task from project
GET/projects/:id/tasksList tasks linked to project
POST/projects/:id/auto-linkAuto-link memories by tag overlap
POST/projects/:id/mindCreate/link a project mind {name?}
GET/projects/:id/mindsList project minds
DELETE/projects/:id/mind/:mindIdRemove a project mind link
GET/memory/:id/projectsList projects linked to a memory
\n

Bắt đầu nhanh

\n
# Ký ức đã liên kết / Endpoint\ncurl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects?status=in_progress&priority=critical"\ncurl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects/stats"\ncurl -s -X POST -H "Authorization: Bearer $MIND_KEY" -H "Content-Type: application/json" \\\n  -d '{"name":"Fleet Pulse","status":"in_progress","priority":"critical","repository_url":"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle"}' \\\n  "https://synapse.schaefer.zone/projects"

Liên kết ký ức và nhiệm vụ

\n\n

Mind dự án

\n

GET /projects/shared-mind (phản hồi: mind, idempotent) · POST /projects/:id/mind {name?} · GET /projects/:id/minds · DELETE /projects/:id/mind/:mindId

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}