[ResponseOps][Rules] Allow users to delete snooze schedule from a rule

oas_docs/bundle.json

@@ -5261,6 +5261,59 @@
         ]
       }
     },
+    "/api/alerting/rule/{ruleId}/snooze_schedule/{scheduleId}": {
+      "delete": {
+        "operationId": "delete-alerting-rule-ruleid-snooze-schedule-scheduleid",
+        "parameters": [
+          {
+            "description": "A required header to protect against CSRF attacks",
+            "in": "header",
+            "name": "kbn-xsrf",
+            "required": true,
+            "schema": {
+              "example": "true",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The identifier for the rule.",
+            "in": "path",
+            "name": "ruleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "The identifier for the snooze schedule.",
+            "in": "path",
+            "name": "scheduleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Indicates a successful call."
+          },
+          "400": {
+            "description": "Indicates an invalid schema."
+          },
+          "403": {
+            "description": "Indicates that this call is forbidden."
+          },
+          "404": {
+            "description": "Indicates a rule with the given id does not exist."
+          }
+        },
+        "summary": "Delete a snooze schedule for a rule",
+        "tags": [
+          "alerting"
+        ]
+      }
+    },
     "/api/alerting/rule/{rule_id}/alert/{alert_id}/_mute": {
       "post": {
         "operationId": "post-alerting-rule-rule-id-alert-alert-id-mute",

oas_docs/bundle.serverless.json

@@ -5261,6 +5261,59 @@
         ]
       }
     },
+    "/api/alerting/rule/{ruleId}/snooze_schedule/{scheduleId}": {
+      "delete": {
+        "operationId": "delete-alerting-rule-ruleid-snooze-schedule-scheduleid",
+        "parameters": [
+          {
+            "description": "A required header to protect against CSRF attacks",
+            "in": "header",
+            "name": "kbn-xsrf",
+            "required": true,
+            "schema": {
+              "example": "true",
+              "type": "string"
+            }
+          },
+          {
+            "description": "The identifier for the rule.",
+            "in": "path",
+            "name": "ruleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "The identifier for the snooze schedule.",
+            "in": "path",
+            "name": "scheduleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Indicates a successful call."
+          },
+          "400": {
+            "description": "Indicates an invalid schema."
+          },
+          "403": {
+            "description": "Indicates that this call is forbidden."
+          },
+          "404": {
+            "description": "Indicates a rule with the given id does not exist."
+          }
+        },
+        "summary": "Delete a snooze schedule for a rule",
+        "tags": [
+          "alerting"
+        ]
+      }
+    },
     "/api/alerting/rule/{rule_id}/alert/{alert_id}/_mute": {
       "post": {
         "operationId": "post-alerting-rule-rule-id-alert-alert-id-mute",

oas_docs/output/kibana.serverless.yaml

@@ -4173,6 +4173,42 @@ paths:
       tags:
         - alerting
       x-beta: true
+  /api/alerting/rule/{ruleId}/snooze_schedule/{scheduleId}:
+    delete:
+      operationId: delete-alerting-rule-ruleid-snooze-schedule-scheduleid
+      parameters:
+        - description: A required header to protect against CSRF attacks
+          in: header
+          name: kbn-xsrf
+          required: true
+          schema:
+            example: 'true'
+            type: string
+        - description: The identifier for the rule.
+          in: path
+          name: ruleId
+          required: true
+          schema:
+            type: string
+        - description: The identifier for the snooze schedule.
+          in: path
+          name: scheduleId
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Indicates a successful call.
+        '400':
+          description: Indicates an invalid schema.
+        '403':
+          description: Indicates that this call is forbidden.
+        '404':
+          description: Indicates a rule with the given id does not exist.
+      summary: Delete a snooze schedule for a rule
+      tags:
+        - alerting
+      x-beta: true
   /api/alerting/rules/_find:
     get:
       operationId: get-alerting-rules-find

oas_docs/output/kibana.yaml

@@ -4524,6 +4524,41 @@ paths:
       summary: Unmute an alert
       tags:
         - alerting
+  /api/alerting/rule/{ruleId}/snooze_schedule/{scheduleId}:
+    delete:
+      operationId: delete-alerting-rule-ruleid-snooze-schedule-scheduleid
+      parameters:
+        - description: A required header to protect against CSRF attacks
+          in: header
+          name: kbn-xsrf
+          required: true
+          schema:
+            example: 'true'
+            type: string
+        - description: The identifier for the rule.
+          in: path
+          name: ruleId
+          required: true
+          schema:
+            type: string
+        - description: The identifier for the snooze schedule.
+          in: path
+          name: scheduleId
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Indicates a successful call.
+        '400':
+          description: Indicates an invalid schema.
+        '403':
+          description: Indicates that this call is forbidden.
+        '404':
+          description: Indicates a rule with the given id does not exist.
+      summary: Delete a snooze schedule for a rule
+      tags:
+        - alerting
   /api/alerting/rules/_find:
     get:
       operationId: get-alerting-rules-find

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/external/schemas/v1.ts

@@ -0,0 +1,15 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import { schema } from '@kbn/config-schema';
+
+export const unsnoozeParamsSchema = schema.object({
+  ruleId: schema.string({meta: { description: 'The identifier for the rule.'}}),
+  scheduleId: schema.string({
+    meta: { description: 'The identifier for the snooze schedule.'}
+  }),
+});

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/external/types/v1.ts

@@ -0,0 +1,10 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import type { TypeOf } from '@kbn/config-schema';
+import type { unsnoozeParamsSchemaV1 } from '../..';
+
+export type UnsnoozeParams = TypeOf<typeof unsnoozeParamsSchemaV1>;

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/index.ts

@@ -5,9 +5,16 @@
  * 2.0.
  */
 
-export { unsnoozeParamsSchema, unsnoozeBodySchema } from './schemas/latest';
+export {
+  unsnoozeParamsInternalSchema,
+  unsnoozeBodyInternalSchema,
+} from './internal/schemas/latest';
+export { unsnoozeParamsSchema } from './external/schemas/latest';
+export type { UnsnoozeParams } from './external/types/latest';
 
 export {
-  unsnoozeParamsSchema as unsnoozeParamsSchemaV1,
-  unsnoozeBodySchema as unsnoozeBodySchemaV1,
-} from './schemas/v1';
+  unsnoozeParamsInternalSchema as unsnoozeParamsInternalSchemaV1,
+  unsnoozeBodyInternalSchema as unsnoozeBodyInternalSchemaV1,
+} from './internal/schemas/v1';
+export { unsnoozeParamsSchema as unsnoozeParamsSchemaV1 } from './external/schemas/v1';
+export type { UnsnoozeParams as UnsnoozeParamsV1 } from './external/types/v1';

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/internal/schemas/latest.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+export * from './v1';

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/schemas/v1.ts → x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/unsnooze/internal/schemas/v1.ts

@@ -7,12 +7,12 @@
 
 import { schema } from '@kbn/config-schema';
 
-export const unsnoozeParamsSchema = schema.object({
+export const unsnoozeParamsInternalSchema = schema.object({
   id: schema.string(),
 });
 
 const scheduleIdsSchema = schema.maybe(schema.arrayOf(schema.string()));
 
-export const unsnoozeBodySchema = schema.object({
+export const unsnoozeBodyInternalSchema = schema.object({
   schedule_ids: scheduleIdsSchema,
 });

x-pack/platform/plugins/shared/alerting/server/application/rule/methods/unsnooze/unsnooze_rule.test.ts

@@ -0,0 +1,71 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { RulesClientContext } from '../../../../rules_client';
+import { unsnoozeRule } from './unsnooze_rule';
+import { savedObjectsRepositoryMock } from '@kbn/core-saved-objects-api-server-mocks';
+
+const loggerErrorMock = jest.fn();
+const getBulkMock = jest.fn();
+
+const savedObjectsMock = savedObjectsRepositoryMock.create();
+savedObjectsMock.get = jest.fn().mockReturnValue({
+  attributes: {
+    actions: [],
+    snoozeSchedule: [
+      {
+        duration: 600000,
+        rRule: {
+          interval: 1,
+          freq: 3,
+          dtstart: '2025-03-01T06:30:37.011Z',
+          tzid: 'UTC',
+        },
+        id: 'snooze_schedule_1',
+      },
+    ],
+  },
+  version: '9.0.0',
+});
+
+const context = {
+  logger: { error: loggerErrorMock },
+  getActionsClient: () => {
+    return {
+      getBulk: getBulkMock,
+    };
+  },
+  unsecuredSavedObjectsClient: savedObjectsMock,
+  authorization: { ensureAuthorized: async () => {} },
+  ruleTypeRegistry: {
+    ensureRuleTypeEnabled: () => {},
+  },
+  getUserName: async () => {},
+} as unknown as RulesClientContext;
+
+describe('validate unsnooze params', () => {
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should validate params correctly', async () => {
+    await expect(
+      unsnoozeRule(context, { id: '123', scheduleIds: ['snooze_schedule_1'] })
+    ).resolves.toBeUndefined();
+  });
+
+  it('should validate params with empty schedule ids correctly', async () => {
+    await expect(unsnoozeRule(context, { id: '123', scheduleIds: [] })).resolves.toBeUndefined();
+  });
+
+  it('should throw bad request for invalid params', async () => {
+    // @ts-expect-error: testing invalid params
+    await expect(unsnoozeRule(context, {})).rejects.toThrowErrorMatchingInlineSnapshot(
+      `"Error validating unsnooze params - [id]: expected value of type [string] but got [undefined]"`
+    );
+  });
+});

x-pack/platform/plugins/shared/alerting/server/routes/index.ts

@@ -38,7 +38,7 @@ import { unmuteAlertRoute } from './rule/apis/unmute_alert/unmute_alert_route';
 import { updateRuleApiKeyRoute } from './rule/apis/update_api_key/update_rule_api_key_route';
 import { bulkEditInternalRulesRoute } from './rule/apis/bulk_edit/bulk_edit_rules_route';
 import { snoozeRuleInternalRoute, snoozeRuleRoute } from './rule/apis/snooze';
-import { unsnoozeRuleRoute } from './rule/apis/unsnooze';
+import { unsnoozeRuleRoute, unsnoozeRuleInternalRoute } from './rule/apis/unsnooze';
 import { runSoonRoute } from './run_soon';
 import { bulkDeleteRulesRoute } from './rule/apis/bulk_delete/bulk_delete_rules_route';
 import { bulkEnableRulesRoute } from './rule/apis/bulk_enable/bulk_enable_rules_route';
@@ -124,6 +124,7 @@ export function defineRoutes(opts: RouteOptions) {
   snoozeRuleInternalRoute(router, licenseState);
   snoozeRuleRoute(router, licenseState);
   unsnoozeRuleRoute(router, licenseState);
+  unsnoozeRuleInternalRoute(router, licenseState);
   cloneRuleRoute(router, licenseState);
   getRuleTagsRoute(router, licenseState);
   registerRulesValueSuggestionsRoute(router, licenseState, config$!);