On this page

2 endpoints.

MethodPathSummary
GET/api/communities/{communityId}/tasks/notifications/meMy task notification settings (إعدادات تنبيهات المهام الخاصة بي)
PUT/api/communities/{communityId}/tasks/notifications/meSave my task notification settings (حفظ إعدادات تنبيهات المهام)

The 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

NameInRequiredTypeDescription
——no——

Responses

StatusDescriptionBody
200The caller's settingsobject
403Missing permission: tasks:manage · NOT_A_COMMUNITY_MEMBER · FEATURE_NOT_AVAILABLE—

Replaces 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

NameInRequiredTypeDescription
——no——

Request body (required) — application/json

FieldTypeRequiredDescription
scopeenum: MINE, ALL, NONEyes—
eventsTaskNotificationEventsyes—
watchUserIdsstring[]noThe 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

StatusDescriptionBody
200The saved settings—
400TASK_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—
403Missing permission: tasks:manage · NOT_A_COMMUNITY_MEMBER · FEATURE_NOT_AVAILABLE—