{"title":"API Projects","slug":"projects","category":"api","summary":"Grupuje wspomnienia, zadania i dedykowane umysły według inicjatywy — projekty niosą status, priorytet, repozytorium i stronę główną oraz wiążą wokół nich pracę.","audience":["human","llm"],"tags":["api","projects","organizacja","portfolio"],"difficulty":"beginner","updated":"2026-10-20","word_count":374,"read_minutes":2,"llm_context":"Auth: Mind Key (lub JWT użytkownika). Wszystkie endpointy są mind-scoped do wywołującego.\nLista: GET /projects?status=in_progress&priority=critical\nUtwórz: POST /projects {name, status?, priority?, repository_url?}\nStatystyki: GET /projects/stats\nSzczegóły: GET /projects/:id (z licznikami memory + task)\nŁączenie: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}\nAuto-link: POST /projects/:id/auto-link (po nakładaniu tagów)\nWspólny umysł: GET /projects/shared-mind (idempotentne)\n","lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# API Projects\n\nProjects to warstwa portfela Synapse: jeden projekt wiąże wspomnienia, zadania, a nawet dedykowane umysły agentów należące do jednej inicjatywy. Każdy projekt niesie status (idea, planning, in_progress, paused, completed, archived, deprecated), priorytet (low, normal, high, critical) oraz opcjonalne URL-e repozytorium/strony głównej — flota raportuje więc per inicjatywa, nie per fragment.\n\nŁączenie jest jawne i odwracalne: wspomnienia i zadania przypina się endpointami link (pojedynczo lub bulk), auto-link po nakładaniu tagów proponuje powiązania hurtowo, a GET /memory/:id/projects odpowiada na pytanie odwrotne. Project mind (GET /projects/shared-mind) daje inicjatywie własną wspólną przestrzeń pamięci, czytelną dla każdego siblinga.\n\n## Co zawiera projekt\n\n| Metoda | Ścieżka | Cel |\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## Szybki start\n\n```bash\n# Powiązane wspomnienia / Endpointy\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## Łączenie wspomnień i zadań\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- `Powiązane wspomnienia`: `GET /projects/:id/memories?limit=200` — odwrotnie: `GET /memory/:id/projects`\n- Przykład: `POST /projects/:id/auto-link` (automatycznie łączy memories na podstawie nakładania tagów)\n\n## Umysły projektu\n\n`GET /projects/shared-mind` (odpowiedź: mind, idempotent) · `POST /projects/:id/mind` {name?} · `GET /projects/:id/minds` · `DELETE /projects/:id/mind/:mindId`\n","content_html":"

API Projects

\n

Projects to warstwa portfela Synapse: jeden projekt wiąże wspomnienia, zadania, a nawet dedykowane umysły agentów należące do jednej inicjatywy. Każdy projekt niesie status (idea, planning, in_progress, paused, completed, archived, deprecated), priorytet (low, normal, high, critical) oraz opcjonalne URL-e repozytorium/strony głównej — flota raportuje więc per inicjatywa, nie per fragment.

\n

Łączenie jest jawne i odwracalne: wspomnienia i zadania przypina się endpointami link (pojedynczo lub bulk), auto-link po nakładaniu tagów proponuje powiązania hurtowo, a GET /memory/:id/projects odpowiada na pytanie odwrotne. Project mind (GET /projects/shared-mind) daje inicjatywie własną wspólną przestrzeń pamięci, czytelną dla każdego siblinga.

\n

Co zawiera projekt

\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
MetodaŚcieżkaCel
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

Szybki start

\n
# Powiązane wspomnienia / Endpointy\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"

Łączenie wspomnień i zadań

\n\n

Umysły projektu

\n

GET /projects/shared-mind (odpowiedź: 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":374,"readMinutes":2,"llmContext":"Auth: Mind Key (lub JWT użytkownika). Wszystkie endpointy są mind-scoped do wywołującego.\nLista: GET /projects?status=in_progress&priority=critical\nUtwórz: POST /projects {name, status?, priority?, repository_url?}\nStatystyki: GET /projects/stats\nSzczegóły: GET /projects/:id (z licznikami memory + task)\nŁączenie: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}\nAuto-link: POST /projects/:id/auto-link (po nakładaniu tagów)\nWspólny umysł: GET /projects/shared-mind (idempotentne)\n","requestedLang":"pl","contentMarkdown":"\n# API Projects\n\nProjects to warstwa portfela Synapse: jeden projekt wiąże wspomnienia, zadania, a nawet dedykowane umysły agentów należące do jednej inicjatywy. Każdy projekt niesie status (idea, planning, in_progress, paused, completed, archived, deprecated), priorytet (low, normal, high, critical) oraz opcjonalne URL-e repozytorium/strony głównej — flota raportuje więc per inicjatywa, nie per fragment.\n\nŁączenie jest jawne i odwracalne: wspomnienia i zadania przypina się endpointami link (pojedynczo lub bulk), auto-link po nakładaniu tagów proponuje powiązania hurtowo, a GET /memory/:id/projects odpowiada na pytanie odwrotne. Project mind (GET /projects/shared-mind) daje inicjatywie własną wspólną przestrzeń pamięci, czytelną dla każdego siblinga.\n\n## Co zawiera projekt\n\n| Metoda | Ścieżka | Cel |\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## Szybki start\n\n```bash\n# Powiązane wspomnienia / Endpointy\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## Łączenie wspomnień i zadań\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- `Powiązane wspomnienia`: `GET /projects/:id/memories?limit=200` — odwrotnie: `GET /memory/:id/projects`\n- Przykład: `POST /projects/:id/auto-link` (automatycznie łączy memories na podstawie nakładania tagów)\n\n## Umysły projektu\n\n`GET /projects/shared-mind` (odpowiedź: mind, idempotent) · `POST /projects/:id/mind` {name?} · `GET /projects/:id/minds` · `DELETE /projects/:id/mind/:mindId`\n","contentHtml":"

API Projects

\n

Projects to warstwa portfela Synapse: jeden projekt wiąże wspomnienia, zadania, a nawet dedykowane umysły agentów należące do jednej inicjatywy. Każdy projekt niesie status (idea, planning, in_progress, paused, completed, archived, deprecated), priorytet (low, normal, high, critical) oraz opcjonalne URL-e repozytorium/strony głównej — flota raportuje więc per inicjatywa, nie per fragment.

\n

Łączenie jest jawne i odwracalne: wspomnienia i zadania przypina się endpointami link (pojedynczo lub bulk), auto-link po nakładaniu tagów proponuje powiązania hurtowo, a GET /memory/:id/projects odpowiada na pytanie odwrotne. Project mind (GET /projects/shared-mind) daje inicjatywie własną wspólną przestrzeń pamięci, czytelną dla każdego siblinga.

\n

Co zawiera projekt

\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
MetodaŚcieżkaCel
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

Szybki start

\n
# Powiązane wspomnienia / Endpointy\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"

Łączenie wspomnień i zadań

\n\n

Umysły projektu

\n

GET /projects/shared-mind (odpowiedź: 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"]}