Task Analytics API

6 endpoints.

Method	Path	Summary
`GET`	`/api/communities/{communityId}/tasks/analytics/export`	Export tasks (تصدير المهام)
`GET`	`/api/communities/{communityId}/tasks/analytics/leaderboard`	Get task leaderboard (لوحة المتصدرين)
`GET`	`/api/communities/{communityId}/tasks/analytics/leaderboard/sections`	Get sections leaderboard stats (إحصائيات الأقسام)
`GET`	`/api/communities/{communityId}/tasks/analytics/leaderboard/sections/{sectionId}/headings`	Get headings leaderboard stats (إحصائيات العناوين)
`GET`	`/api/communities/{communityId}/tasks/analytics/members/{memberId}`	Get member analytics (تحليلات العضو)
`GET`	`/api/communities/{communityId}/tasks/analytics/overview`	Get analytics overview (نظرة عامة على التحليلات)

GET /api/communities/{communityId}/tasks/analytics/export

Exports all tasks as CSV or Excel file. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`format`	query	yes	enum: `csv`, `excel`	Export format

Responses

Status	Description	Body
`200`	File download	string (binary)
`403`	Requires tasks:manage permission	—

GET /api/communities/{communityId}/tasks/analytics/leaderboard

Returns members ranked by points earned from completed tasks Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`—`	—	no	—	—
`—`	—	no	—	—
`sectionId`	query	no	string (uuid)	Filter by section
`headingId`	query	no	string (uuid)	Filter by heading
`taskId`	query	no	string (uuid)	Filter by specific task

Responses

Status	Description	Body
`200`	Ranked leaderboard entries	object

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

Returns all sections with task statistics and top performers Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`200`	Sections with statistics	object

GET /api/communities/{communityId}/tasks/analytics/leaderboard/sections/{sectionId}/headings

Returns all headings under a section with task statistics and top performers Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`200`	Headings with statistics	object

GET /api/communities/{communityId}/tasks/analytics/members/{memberId}

Returns task analytics for a specific member. Requires tasks:manage permission. Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`—`	—	no	—	—
`memberId`	path	yes	string (uuid)	Member ID

Responses

Status	Description	Body
`200`	Member's task analytics	object
`403`	Requires tasks:manage permission	—
`404`	Member not found	—

GET /api/communities/{communityId}/tasks/analytics/overview

Returns comprehensive task statistics including completion rates, status distribution, and trends Auth: Bearer JWT required.

Parameters

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

Responses

Status	Description	Body
`200`	Task analytics overview	object