Project Setup Templates API

All endpoints require authentication and templates tool permissions. Routes are mounted under /api/admin/project-setup-templates.

Templates

List Templates

GET /api/admin/project-setup-templates

Returns all project setup templates with computed phase_count, task_count, and created_by_name.

Permission: templates:view

Response: { templates }

---

Get Template Detail

GET /api/admin/project-setup-templates/:id

Returns a template with nested phases and tasks.

Permission: templates:view

Path parameters:

Param	Type	Description
id	string	Template ID

Response: { template, phases }

Each phase includes a nested tasks array.

Error: 404 if template not found.

---

Create Template

POST /api/admin/project-setup-templates

Permission: templates:update

Body:

Field	Type	Required	Description
name	string	Yes	Template name
description	string	No	Template description
default_type_id	string	No	Default project type ID
default_squad	string	No	Default squad
is_global	boolean	No	Whether template is global (default: true)

Response: { template } (201)

---

Update Template

PUT /api/admin/project-setup-templates/:id

Permission: templates:update

Path parameters:

Param	Type	Description
id	string	Template ID

Body (all fields optional): name, description, default_type_id, default_squad, is_global

Response: { ok: true }

---

Delete Template

DELETE /api/admin/project-setup-templates/:id

Cascade-deletes phases and tasks. If the template has been used (use_count > 0) and confirm is not set, returns a warning instead.

Permission: templates:manage

Path parameters:

Param	Type	Description
id	string	Template ID

Query parameters:

Param	Type	Description
confirm	string	Set to true to confirm deletion of a used template

Response: { ok: true } or { warning: true, use_count, message } (409)

Error: 404 if template not found.

---

Duplicate Template

POST /api/admin/project-setup-templates/:id/duplicate

Creates a copy of the template including all phases and tasks. Named Copy of {original name}.

Permission: templates:update

Path parameters:

Param	Type	Description
id	string	Source template ID

Response: { template } (201)

Error: 404 if source template not found.

---

Phases

Create Phase

POST /api/admin/project-setup-templates/:id/phases

Permission: templates:update

Body:

Field	Type	Required	Description
name	string	Yes	Phase name
description	string	No	Phase description
duration_days	number	No	Expected duration in days
sort_order	number	No	Sort position (default: 0)

Response: { phase } (201)

---

Update Phase

PUT /api/admin/project-setup-template-phases/:phaseId

Permission: templates:update

Body (all fields optional): name, description, sort_order, duration_days

Response: { ok: true }

---

Delete Phase

DELETE /api/admin/project-setup-template-phases/:phaseId

Cascade-deletes all tasks within the phase.

Permission: templates:manage

Response: { ok: true }

---

Reorder Phases

POST /api/admin/project-setup-template-phases/reorder

Bulk reorder phases by providing an ordered array of IDs.

Permission: templates:update

Body:

Field	Type	Required	Description
ids	string[]	Yes	Ordered array of phase IDs

Response: { ok: true }

---

Tasks

Create Task

POST /api/admin/project-setup-template-phases/:phaseId/tasks

Permission: templates:update

Body:

Field	Type	Required	Description
title	string	Yes	Task title
description	string	No	Task description
sort_order	number	No	Sort position (default: 0)
default_assignee_role	string	No	Default assignee role

Response: { task } (201)

---

Update Task

PUT /api/admin/project-setup-template-tasks/:taskId

Permission: templates:update

Body (all fields optional): title, description, sort_order, default_assignee_role

Response: { ok: true }

---

Delete Task

DELETE /api/admin/project-setup-template-tasks/:taskId

Permission: templates:manage

Response: { ok: true }