Tasks API

6 endpoints.

Method	Path	Summary
`GET`	`/api/communities/{communityId}/tasks`	List all tasks (قائمة المهام)
`POST`	`/api/communities/{communityId}/tasks`	Create task (إنشاء مهمة)
`DELETE`	`/api/communities/{communityId}/tasks/{taskId}`	Delete task (حذف المهمة)
`GET`	`/api/communities/{communityId}/tasks/{taskId}`	Get task by ID (تفاصيل المهمة)
`PUT`	`/api/communities/{communityId}/tasks/{taskId}`	Update task (تحديث المهمة)
`POST`	`/api/communities/{communityId}/tasks/{taskId}/duplicate`	Duplicate task (تكرار المهمة)

GET /api/communities/{communityId}/tasks

Returns paginated list of tasks with optional filters Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—
`—`	—	no	—	—
`status`	query	no	TaskStatus	Filter by status
`priority`	query	no	TaskPriority	Filter by priority
`headingId`	query	no	string (uuid)	Filter by heading
`sectionId`	query	no	string (uuid)	Filter by section
`assigneeId`	query	no	string (uuid)	Filter by assignee
`search`	query	no	string	Search in title and description

Responses

Status	Description	Body
`200`	Paginated list of tasks	TasksListResponse

POST /api/communities/{communityId}/tasks

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

Parameters

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

Request body (required) — application/json

Responses

Status	Description	Body
`201`	Task created successfully	object
`400`	Invalid request body	—
`403`	Requires tasks:manage permission	—

DELETE /api/communities/{communityId}/tasks/{taskId}

Deletes a task and all its assignments. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

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

Responses

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

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

Returns a single task with full details including assignments, dependencies, and activity Auth: Bearer JWT required.

Parameters

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

Responses

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

PUT /api/communities/{communityId}/tasks/{taskId}

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

Parameters

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

Request body (required) — application/json

Responses

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

POST /api/communities/{communityId}/tasks/{taskId}/duplicate

Creates a copy of an existing task. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`201`	Task duplicated successfully	object
`403`	Requires tasks:manage permission	—
`404`	Task not found	—