• 유효한 알림 수준
• 전체 알림 설정
• 전체 알림 설정 업데이트
• 그룹/프로젝트 수준 알림 설정
• 그룹/프로젝트 수준 알림 설정 업데이트

알림 설정 API

REST API를 사용하여 알림 설정을 변경하세요.

유효한 알림 수준

알림 수준은 NotificationSetting.level 모델 열거형에서 정의됩니다. 현재는 다음과 같은 수준이 인식됩니다:

• disabled
• participating
• watch
• global
• mention
• custom

custom 수준이 사용되면 특정 이메일 이벤트를 제어할 수 있습니다. 사용 가능한 이벤트는 NotificationSetting.email_events에서 반환됩니다. 현재 인식되는 이벤트는 다음과 같습니다:

• new_note
• new_issue
• reopen_issue
• close_issue
• reassign_issue
• issue_due
• new_merge_request
• push_to_merge_request
• reopen_merge_request
• close_merge_request
• reassign_merge_request
• merge_merge_request
• failed_pipeline
• fixed_pipeline
• success_pipeline
• moved_project
• merge_when_pipeline_succeeds
• new_epic Ultimate만 해당합니다.

전체 알림 설정

현재 알림 설정과 이메일 주소를 가져오세요.

GET /notification_settings

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/notification_settings"

예제 응답:

{
  "level": "participating",
  "notification_email": "admin@example.com"
}

전체 알림 설정 업데이트

현재 알림 설정과 이메일 주소를 업데이트하세요.

PUT /notification_settings

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/notification_settings?level=watch"

예제 응답:

{
  "level": "watch",
  "notification_email": "admin@example.com"
}

그룹/프로젝트 수준 알림 설정

현재 그룹 또는 프로젝트의 알림 설정을 가져옵니다.

GET /groups/:id/notification_settings
GET /projects/:id/notification_settings

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/notification_settings"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/8/notification_settings"

예시 응답:

{
  "level": "global"
}

그룹/프로젝트 수준 알림 설정 업데이트

현재 그룹/프로젝트 알림 설정을 업데이트합니다.

PUT /groups/:id/notification_settings
PUT /projects/:id/notification_settings

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/notification_settings?level=watch"
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/8/notification_settings?level=custom&new_note=true"

예시 응답:

{
  "level": "watch"
}

{
  "level": "custom",
  "events": {
    "new_note": true,
    "new_issue": false,
    "reopen_issue": false,
    "close_issue": false,
    "reassign_issue": false,
    "issue_due": false,
    "new_merge_request": false,
    "push_to_merge_request": false,
    "reopen_merge_request": false,
    "close_merge_request": false,
    "reassign_merge_request": false,
    "merge_merge_request": false,
    "failed_pipeline": false,
    "fixed_pipeline": false,
    "success_pipeline": false
  }
}

GitLab Ultimate 사용자도 전역 및 그룹 수준 알림 설정에 대해 new_epic 매개변수를 볼 수 있습니다:

{
  "level": "custom",
  "events": {
    "new_note": true,
    "new_issue": false,
    "new_epic": false,
    ...
  }
}