Task Templates API

8 endpoints.

Method	Path	Summary
`GET`	`/api/communities/{communityId}/tasks/templates`	List templates (قائمة القوالب)
`POST`	`/api/communities/{communityId}/tasks/templates`	Create template manually (إنشاء قالب)
`DELETE`	`/api/communities/{communityId}/tasks/templates/{templateId}`	Delete template (حذف القالب)
`GET`	`/api/communities/{communityId}/tasks/templates/{templateId}`	Get template by ID (تفاصيل القالب)
`PUT`	`/api/communities/{communityId}/tasks/templates/{templateId}`	Update template (تحديث القالب)
`POST`	`/api/communities/{communityId}/tasks/templates/{templateId}/apply`	Apply template (تطبيق القالب)
`GET`	`/api/communities/{communityId}/tasks/templates/categories`	Get template categories (فئات القوالب)
`POST`	`/api/communities/{communityId}/tasks/templates/from-task`	Create template from task (إنشاء قالب من مهمة)

List templates (قائمة القوالب)

GET /api/communities/{communityId}/tasks/templates

Returns all task templates with optional category filter Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`category`	query	no	string	Filter by category

Responses

Status	Description	Body
`200`	List of templates	object

Create template manually (إنشاء قالب)

POST /api/communities/{communityId}/tasks/templates

Creates a new task template from scratch. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—

Request body (required) — application/json

Type: CreateTemplateRequest

Responses

Status	Description	Body
`201`	Template created	object
`403`	Requires tasks:manage permission	—

Delete template (حذف القالب)

DELETE /api/communities/{communityId}/tasks/templates/{templateId}

Deletes a task template. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—

Responses

Status	Description	Body
`200`	Template deleted	—
`403`	Requires tasks:manage permission	—
`404`	Template not found	—

Get template by ID (تفاصيل القالب)

GET /api/communities/{communityId}/tasks/templates/{templateId}

Returns a single template with its data Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—

Responses

Status	Description	Body
`200`	Template details	object
`404`	Template not found	—

Update template (تحديث القالب)

PUT /api/communities/{communityId}/tasks/templates/{templateId}

Updates an existing template. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—

Request body (required) — application/json

Type: CreateTemplateRequest

Responses

Status	Description	Body
`200`	Template updated	—
`403`	Requires tasks:manage permission	—
`404`	Template not found	—

Apply template (تطبيق القالب)

POST /api/communities/{communityId}/tasks/templates/{templateId}/apply

Creates a new task from a template with optional customizations. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—

Request body (required) — application/json

Type: ApplyTemplateRequest

Responses

Status	Description	Body
`201`	Task created from template	object
`403`	Requires tasks:manage permission	—
`404`	Template not found	—

Get template categories (فئات القوالب)

GET /api/communities/{communityId}/tasks/templates/categories

Returns list of all unique template categories Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—

Responses

Status	Description	Body
`200`	List of categories	object

Create template from task (إنشاء قالب من مهمة)

POST /api/communities/{communityId}/tasks/templates/from-task

Creates a reusable template from an existing task. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—

Request body (required) — application/json

Type: CreateTemplateFromTaskRequest

Responses

Status	Description	Body
`201`	Template created successfully	object
`403`	Requires tasks:manage permission	—
`404`	Source task not found	—