feat(specs): add notification settings to tasks [skip-bc]

specs/ingestion/common/schemas/task.yml

@@ -26,6 +26,8 @@ Task:
       $ref: '#/ActionType'
     cursor:
       $ref: './common.yml#/cursor'
+    notifications:
+      $ref: '#/Notifications'
     createdAt:
       $ref: './common.yml#/createdAt'
     updatedAt:
@@ -41,7 +43,7 @@ TaskV1:
   type: object
   additionalProperties: false
   deprecated: true
-  description: The V1 task object, please use methods and types that don't contain the V1 suffix.
+  description: The V1 task object, please use methods and types that doesn't contain the V1 suffix.
   properties:
     taskID:
       $ref: './common.yml#/taskID'
@@ -63,6 +65,8 @@ TaskV1:
       $ref: '#/ActionType'
     cursor:
       $ref: './common.yml#/cursor'
+    notifications:
+      $ref: '#/Notifications'
     createdAt:
       $ref: './common.yml#/createdAt'
     updatedAt:
@@ -105,6 +109,8 @@ TaskCreate:
       $ref: '#/TaskInput'
     cursor:
       $ref: './common.yml#/cursor'
+    notifications:
+      $ref: '#/Notifications'
   required:
     - sourceID
     - destinationID
@@ -175,6 +181,8 @@ TaskUpdate:
       description: Whether the task is enabled.
     failureThreshold:
       $ref: '#/failureThreshold'
+    notifications:
+      $ref: '#/Notifications'
 
 TaskUpdateV1:
   type: object
@@ -553,3 +561,24 @@ ShopifyMarket:
     - countries
     - currencies
     - locales
+
+Notifications:
+  type: object
+  additionalProperties: false
+  description: Notifications settings for a task.
+  properties:
+    email:
+      title: emailNotifications
+      type: object
+      additionalProperties: false
+      properties:
+        enabled:
+          description: Whether to send email notifications, note that this doesn't prevent the task from being blocked.
+          type: boolean
+        criticalThreshold:
+          description: The number of critical failures in a row before blocking the task and sending a notification.
+          type: integer
+          minimum: 1
+          maximum: 10
+  required:
+    - email

specs/ingestion/common/taskParameters.yml

@@ -70,6 +70,14 @@ triggerType:
       $ref: './schemas/task.yml#/TriggerType'
     example: onDemand,schedule,subscription,streaming
 
+withNotifications:
+  name: withNotifications
+  in: query
+  description: If specified, the response only includes tasks with notifications.email.enabled set to this value.
+  required: false
+  schema:
+    type: boolean
+
 sort:
   name: sort
   in: query

specs/ingestion/paths/tasks/v2/tasks.yml

@@ -17,6 +17,7 @@ get:
     - $ref: '../../../common/taskParameters.yml#/sourceType'
     - $ref: '../../../common/taskParameters.yml#/destinationID'
     - $ref: '../../../common/taskParameters.yml#/triggerType'
+    - $ref: '../../../common/taskParameters.yml#/withNotifications'
     - $ref: '../../../common/taskParameters.yml#/sort'
     - $ref: '../../../common/parameters.yml#/order'
   responses:

tests/CTS/requests/ingestion/createTask.json

@@ -22,7 +22,13 @@
       "sourceID": "search",
       "destinationID": "destinationName",
       "cron": "* * * * *",
-      "action": "replace"
+      "action": "replace",
+      "notifications": {
+        "email": {
+          "enabled": true,
+          "criticalThreshold": 8
+        }
+      }
     },
     "request": {
       "path": "/2/tasks",
@@ -31,7 +37,13 @@
         "sourceID": "search",
         "destinationID": "destinationName",
         "cron": "* * * * *",
-        "action": "replace"
+        "action": "replace",
+        "notifications": {
+          "email": {
+            "enabled": true,
+            "criticalThreshold": 8
+          }
+        }
       }
     }
   },