Update global notification settings

PUT

/api/v4/notification_settings

• GitLab REST API

Updates notification settings and email address.

Authorizations

• http
• oauth2

Request Body

Media type application/json

object

level

The global notification level

string

nullable

notification_email

The email address to send notifications

string

nullable

new_release

Enable/disable this notification

boolean

nullable

new_note

Enable/disable this notification

boolean

nullable

new_issue

Enable/disable this notification

boolean

nullable

reopen_issue

Enable/disable this notification

boolean

nullable

close_issue

Enable/disable this notification

boolean

nullable

reassign_issue

Enable/disable this notification

boolean

nullable

issue_due

Enable/disable this notification

boolean

nullable

new_merge_request

Enable/disable this notification

boolean

nullable

push_to_merge_request

Enable/disable this notification

boolean

nullable

reopen_merge_request

Enable/disable this notification

boolean

nullable

close_merge_request

Enable/disable this notification

boolean

nullable

reassign_merge_request

Enable/disable this notification

boolean

nullable

change_reviewer_merge_request

Enable/disable this notification

boolean

nullable

merge_merge_request

Enable/disable this notification

boolean

nullable

failed_pipeline

Enable/disable this notification

boolean

nullable

fixed_pipeline

Enable/disable this notification

boolean

nullable

success_pipeline

Enable/disable this notification

boolean

nullable

moved_project

Enable/disable this notification

boolean

nullable

merge_when_pipeline_succeeds

Enable/disable this notification

boolean

nullable

new_epic

Enable/disable this notification

boolean

nullable

service_account_failed_pipeline

Enable/disable this notification

boolean

nullable

service_account_success_pipeline

Enable/disable this notification

boolean

nullable

service_account_fixed_pipeline

Enable/disable this notification

boolean

nullable

approver

Enable/disable this notification

boolean

nullable

Example ^generated

{
  "level": "example",
  "notification_email": "example",
  "new_release": true,
  "new_note": true,
  "new_issue": true,
  "reopen_issue": true,
  "close_issue": true,
  "reassign_issue": true,
  "issue_due": true,
  "new_merge_request": true,
  "push_to_merge_request": true,
  "reopen_merge_request": true,
  "close_merge_request": true,
  "reassign_merge_request": true,
  "change_reviewer_merge_request": true,
  "merge_merge_request": true,
  "failed_pipeline": true,
  "fixed_pipeline": true,
  "success_pipeline": true,
  "moved_project": true,
  "merge_when_pipeline_succeeds": true,
  "new_epic": true,
  "service_account_failed_pipeline": true,
  "service_account_success_pipeline": true,
  "service_account_fixed_pipeline": true,
  "approver": true
}

Responses

200

OK

Media type application/json

object

level

string

events

string

notification_email

string

Example ^generated

{
  "level": "example",
  "events": "example",
  "notification_email": "example"
}

400

Bad request

401

Unauthorized