4.4.1: API definition

Author: geropl

components/public-api/gitpod/v1/organization.proto

@@ -153,6 +153,12 @@ service OrganizationService {
 
   // SetOrganizationMaintenanceMode sets the maintenance mode status for an organization.
   rpc SetOrganizationMaintenanceMode(SetOrganizationMaintenanceModeRequest) returns (SetOrganizationMaintenanceModeResponse) {}
+
+  // GetScheduledMaintenanceNotification retrieves the scheduled maintenance notification settings for an organization.
+  rpc GetScheduledMaintenanceNotification(GetScheduledMaintenanceNotificationRequest) returns (GetScheduledMaintenanceNotificationResponse) {}
+
+  // SetScheduledMaintenanceNotification sets the scheduled maintenance notification for an organization.
+  rpc SetScheduledMaintenanceNotification(SetScheduledMaintenanceNotificationRequest) returns (SetScheduledMaintenanceNotificationResponse) {}
 }
 
 message ListOrganizationWorkspaceClassesRequest {
@@ -408,3 +414,37 @@ message SetOrganizationMaintenanceModeResponse {
   // enabled indicates the new maintenance mode status after the update.
   bool enabled = 1;
 }
+
+message GetScheduledMaintenanceNotificationRequest {
+  // organization_id is the ID of the organization to retrieve the notification settings for.
+  string organization_id = 1;
+}
+
+message GetScheduledMaintenanceNotificationResponse {
+  // is_enabled indicates whether the scheduled maintenance notification is enabled.
+  bool is_enabled = 1;
+
+  // message is the custom message stored, if any. Empty or not present if no custom message is set.
+  // The frontend will use its own default if this is empty/undefined and is_enabled is true.
+  string message = 2;
+}
+
+message SetScheduledMaintenanceNotificationRequest {
+  // organization_id is the ID of the organization to set the notification settings for.
+  string organization_id = 1;
+
+  // is_enabled indicates whether the scheduled maintenance notification should be enabled or disabled.
+  bool is_enabled = 2;
+
+  // custom_message is the user-provided custom message for the notification.
+  // If not provided or empty, the backend stores undefined/empty for the message.
+  optional string custom_message = 3;
+}
+
+message SetScheduledMaintenanceNotificationResponse {
+  // is_enabled indicates the new notification enabled status after the update.
+  bool is_enabled = 1;
+
+  // message is the custom message that is now stored, if any.
+  optional string message = 2;
+}