Documentation for X-GitLab-NotificationReason missing possible values

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

• Close this issue

Problem to solve

The Notification emails documentation is missing possible values for x-GitLab-NotificationReason. According to https://gitlab.com/gitlab-org/gitlab/-/blob/2847f7953898bbdec0d67b87510f51b78dc91af9/app/models/notification_reason.rb#L5, the following reasons are available:

• own_activity
• assigned
• review_requested
• mentioned
• subscribed

However, the following are not included in the documentation:

• review_requested
• subscribed

I'm not sure if the latter (subscribed) is used, but the former (review_requested) is used and undocumented.

Proposal

review_requested should be added as a potential X-GitLab-NotificationReason. If subscribed is actively used, it should be added too.

Other links/references

• #326306
• #20689