2 endpoints.
| Method | Path | Summary |
|---|---|---|
GET | /api/communities/{communityId}/tasks/notifications/me | My task notification settings (إعدادات تنبيهات المهام الخاصة بي) |
PUT | /api/communities/{communityId}/tasks/notifications/me | Save my task notification settings (حفظ إعدادات تنبيهات المهام) |
GET /api/communities/{communityId}/tasks/notifications/meThe caller's own choices as a task manager: scope (MINE = members I supervise, ALL = every member, NONE = nothing) and, for each of nine task events, whether it arrives in-app (app) and/or by e-mail (mail). saved: false means the caller never saved, and the values shown are what every manager received before this setting existed (completions and help requests in-app, help requests by e-mail, from every member). Takes no member id — the membership comes from the token. With scope MINE the caller hears about the members he supervises (supervisedUserIds, set on the members page) and the members he picked (watchUserIds); several managers may pick the same member. A member nobody supervises and nobody picked reaches the community admins.
Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | The caller's settings | object |
403 | Missing permission: tasks:manage · NOT_A_COMMUNITY_MEMBER · FEATURE_NOT_AVAILABLE | — |
PUT /api/communities/{communityId}/tasks/notifications/meReplaces the caller's settings. Every event sent must be a known one with boolean app and mail; an event left out keeps its default. Saving the same values twice succeeds. Slack is not a channel here — which events reach Slack is chosen per webhook (/tasks/webhooks).
Auth: Bearer JWT required.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
— | — | no | — | — |
Request body (required) — application/json
| Field | Type | Required | Description |
|---|---|---|---|
scope | enum: MINE, ALL, NONE | yes | — |
events | TaskNotificationEvents | yes | — |
watchUserIds | string[] | no | The FULL list of members (User ids) to follow under scope MINE. Leave it out to keep the saved list; send [] to follow nobody. Every id must be an approved member of this community, or nothing is saved. |
Responses
| Status | Description | Body |
|---|---|---|
200 | The saved settings | — |
400 | TASK_NOTIFY_INVALID_BODY · TASK_NOTIFY_INVALID_SCOPE · TASK_NOTIFY_UNKNOWN_EVENT · TASK_NOTIFY_INVALID_CHANNEL · TASK_NOTIFY_INVALID_MEMBERS · TASK_NOTIFY_TOO_MANY_MEMBERS · TASK_NOTIFY_UNKNOWN_MEMBER | — |
403 | Missing permission: tasks:manage · NOT_A_COMMUNITY_MEMBER · FEATURE_NOT_AVAILABLE | — |