Notification settings

You can define notification settings globally, for groups and for projects. Valid levels are defined as constants:

  • gitlab.NOTIFICATION_LEVEL_DISABLED

  • gitlab.NOTIFICATION_LEVEL_PARTICIPATING

  • gitlab.NOTIFICATION_LEVEL_WATCH

  • gitlab.NOTIFICATION_LEVEL_GLOBAL

  • gitlab.NOTIFICATION_LEVEL_MENTION

  • gitlab.NOTIFICATION_LEVEL_CUSTOM

You get access to fine-grained settings if you use the NOTIFICATION_LEVEL_CUSTOM level.

Examples

Get the notifications settings:

# global settings settings = gl.notificationsettings.get() # for a group settings = gl.groups.get(group_id).notificationsettings.get() # for a project settings = gl.projects.get(project_id).notificationsettings.get()

Update the notifications settings:

# use a predefined level settings.level = gitlab.NOTIFICATION_LEVEL_WATCH # create a custom setup settings.level = gitlab.NOTIFICATION_LEVEL_CUSTOM settings.save() # will create additional attributes, but not mandatory settings.new_merge_request = True settings.new_issue = True settings.new_note = True settings.save()