Task Sections API

6 endpoints.

Method	Path	Summary
`GET`	`/api/communities/{communityId}/tasks/sections`	List all task sections (قائمة الأقسام)
`POST`	`/api/communities/{communityId}/tasks/sections`	Create new section (إنشاء قسم)
`DELETE`	`/api/communities/{communityId}/tasks/sections/{sectionId}`	Delete section (حذف القسم)
`GET`	`/api/communities/{communityId}/tasks/sections/{sectionId}`	Get section by ID (تفاصيل القسم)
`PUT`	`/api/communities/{communityId}/tasks/sections/{sectionId}`	Update section (تحديث القسم)
`POST`	`/api/communities/{communityId}/tasks/sections/reorder`	Reorder sections (إعادة ترتيب الأقسام)

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

Returns all task sections with headings count and tasks count Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`200`	List of sections with statistics	object
`401`	Unauthorized - JWT token missing or invalid	—
`403`	Forbidden - Not a community member	—

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

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

Parameters

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

Request body (required) — multipart/form-data

Field	Type	Required	Description
`name`	string	yes	—
`icon`	string (binary)	no	Section icon image (optional)
`description`	string	no	—
`primaryColor`	string	no	—
`secondaryColor`	string	no	—
`visibilityType`	SectionVisibilityType	no	—
`memberIds`	string[]	no	For SPECIFIC_MEMBERS visibility

Responses

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

DELETE /api/communities/{communityId}/tasks/sections/{sectionId}

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

Parameters

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

Responses

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

GET /api/communities/{communityId}/tasks/sections/{sectionId}

Returns a single section with its headings and task counts Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`200`	Section details with headings	object
`404`	Section not found	—

PUT /api/communities/{communityId}/tasks/sections/{sectionId}

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

Parameters

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

Request body (required) — multipart/form-data

Responses

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

POST /api/communities/{communityId}/tasks/sections/reorder

Updates the sort order of all sections. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

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

Request body (required) — application/json

Responses

Status	Description	Body
`200`	Sections reordered successfully	—
`403`	Requires tasks:manage permission	—