Task assignments - assign tasks to members/groups/roles (تعيينات المهام)
10 endpoints.
| Method | Path | Summary |
|---|---|---|
GET | /api/communities/{communityId}/tasks/{taskId}/assignments | Get task assignments (تعيينات المهمة) |
POST | /api/communities/{communityId}/tasks/{taskId}/assignments | Assign task (تعيين مهمة) |
DELETE | /api/communities/{communityId}/tasks/assignments/{assignmentId} | Remove assignment (إزالة التعيين) |
POST | /api/communities/{communityId}/tasks/assignments/{assignmentId}/request-help | Request help (طلب مساعدة) |
POST | /api/communities/{communityId}/tasks/assignments/{assignmentId}/resolve-help | Resolve help request (حل طلب المساعدة) |
PUT | /api/communities/{communityId}/tasks/assignments/{assignmentId}/status | Update assignment status (تحديث حالة التعيين) |
GET | /api/communities/{communityId}/tasks/help-requests | Get all help requests (طلبات المساعدة) |
GET | /api/communities/{communityId}/tasks/member-assignments/{memberId} | Get member's assignments (مهام العضو) |
GET | /api/communities/{communityId}/tasks/my-assignments | Get my task assignments (مهامي) |
GET | /api/communities/{communityId}/tasks/overdue | Overdue tasks for the admin inbox (مهام تجاوزت موعدها) |
GET /api/communities/{communityId}/tasks/{taskId}/assignmentsReturns all assignments for a specific task Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | List of assignments | object |
POST /api/communities/{communityId}/tasks/{taskId}/assignmentsAssigns a task to members, groups, or roles. Requires tasks:manage permission. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Request body (required) — application/json
Type: AssignTaskRequest
Responses
| Status | Description | Body |
|---|---|---|
201 | Assignments created | object |
403 | Requires tasks:manage permission | — |
DELETE /api/communities/{communityId}/tasks/assignments/{assignmentId}Removes an assignment from a task. Requires tasks:manage permission. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | Assignment removed | — |
403 | Requires tasks:manage permission | — |
404 | Assignment not found | — |
POST /api/communities/{communityId}/tasks/assignments/{assignmentId}/request-helpSubmits a help request for an assignment. The admin will be notified. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Request body (required) — application/json
Type: RequestHelpRequest
Responses
| Status | Description | Body |
|---|---|---|
200 | Help request submitted | object |
403 | Can only request help for own assignment | — |
POST /api/communities/{communityId}/tasks/assignments/{assignmentId}/resolve-helpMarks a help request as resolved. Requires tasks:manage permission. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Request body — application/json
| Field | Type | Required | Description |
|---|---|---|---|
resolution | string | no | Resolution message (optional) |
Responses
| Status | Description | Body |
|---|---|---|
200 | Help request resolved | — |
403 | Requires tasks:manage permission | — |
404 | Assignment not found | — |
PUT /api/communities/{communityId}/tasks/assignments/{assignmentId}/statusUpdates the status of an assignment. Members can update their own assignments. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
Request body (required) — application/json
Type: UpdateAssignmentStatusRequest
Responses
| Status | Description | Body |
|---|---|---|
200 | Status updated | object |
403 | Can only update own assignment | — |
404 | Assignment not found | — |
GET /api/communities/{communityId}/tasks/help-requestsReturns all assignments where members have requested help. Requires tasks:manage permission. Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
— | — | no | — | — |
— | — | no | — | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | List of help requests | object |
403 | Requires tasks:manage permission | — |
GET /api/communities/{communityId}/tasks/member-assignments/{memberId}Returns all tasks assigned to 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 to view assignments for |
Responses
| Status | Description | Body |
|---|---|---|
200 | Member's assigned tasks with stats | MyTasksResponse |
403 | Requires tasks:manage permission | — |
GET /api/communities/{communityId}/tasks/my-assignmentsReturns all tasks assigned to the current user with statistics Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | User's assigned tasks with stats | MyTasksResponse |
GET /api/communities/{communityId}/tasks/overduePast-due, not-completed tasks that at least one assignee still owes, oldest due date first, with their section and heading. Requires tasks:manage permission.
Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
limit | query | no | integer | How many tasks to return (total is always the full count) |
Responses
| Status | Description | Body |
|---|---|---|
200 | Overdue tasks | object |
403 | Requires tasks:manage permission | — |