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

oas_docs/bundle.json

@@ -4365,6 +4365,57 @@
         ]
       }
     },
+    "/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"
+            }
+          },
+          {
+            "in": "path",
+            "name": "ruleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "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

@@ -4365,6 +4365,57 @@
         ]
       }
     },
+    "/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"
+            }
+          },
+          {
+            "in": "path",
+            "name": "ruleId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "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

@@ -3475,6 +3475,40 @@ 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
+        - in: path
+          name: ruleId
+          required: true
+          schema:
+            type: string
+        - 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

@@ -3818,6 +3818,39 @@ 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
+        - in: path
+          name: ruleId
+          required: true
+          schema:
+            type: string
+        - 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,13 @@
+/*
+ * 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(),
+  scheduleId: schema.string(),
+});

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 { TypeOf } from '@kbn/config-schema';
+import { 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,115 @@
+/*
+ * 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 { 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]"`
+    );
+  });
+
+  it('should throw bad request for when snooze schedule is empty for public route', async () => {
+    savedObjectsMock.get = jest.fn().mockReturnValue({
+      attributes: {
+        actions: [],
+        snoozeSchedule: [],
+      },
+      version: '9.0.0',
+    });
+    await expect(
+      unsnoozeRule(context, { id: '123', scheduleIds: ['snooze_schedule_1'], isPublic: true })
+    ).rejects.toThrowErrorMatchingInlineSnapshot(`"Rule has no snooze schedules."`);
+  });
+
+  it('should throw bad request for invalid snooze schedule id for public route', async () => {
+    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 invalidParams = {
+      id: '123',
+      scheduleIds: ['random_schedule_id'],
+      isPublic: true,
+    };
+
+    await expect(unsnoozeRule(context, invalidParams)).rejects.toThrowErrorMatchingInlineSnapshot(
+      `"Rule has no snooze schedule with id random_schedule_id."`
+    );
+  });
+});