@snokam/mcp-api 1.21.1 → 2.0.1

package/specs/test/notifications.json

@@ -11,6 +11,223 @@
     }
   ],
   "paths": {
+    "/v1.0/protected/health/{provider}": {
+      "get": {
+        "tags": [
+          "Health"
+        ],
+        "summary": "Checks an integration's connectivity",
+        "operationId": "NotificationsIntegrationHealth",
+        "parameters": [
+          {
+            "name": "provider",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Health result",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/integrationHealthResult"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/newsletter/trigger": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Trigger newsletter summarizer",
+        "description": "Manually runs the weekly knowledge-summarizer cron (iterates active newsletterSeries, posts Olaf's summary to the configured Slack channel per series, and emails subscribers for series with sendEmails=true).",
+        "operationId": "TriggerKnowledgeSummarizer",
+        "responses": {
+          "200": {
+            "description": "Summarizer run completed",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/newsletter/debug": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Preview newsletters by email",
+        "description": "Generates Olaf's summary for each active newsletterSeries and emails the rendered body (same composition the real cron uses) to the caller-supplied address. Skips Sanity persistence, Slack posts, and the 7-day dedup check — subscribers are never touched. Defaults to utvikling@snokam.no.",
+        "operationId": "DebugNewsletterEmail",
+        "parameters": [
+          {
+            "name": "to",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Recipient email (defaults to utvikling@snokam.no)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Preview sent"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/alerts/azure": {
+      "post": {
+        "tags": [
+          "Alerts"
+        ],
+        "summary": "Receive Azure Monitor alert",
+        "description": "Action Group webhook receiver for the Azure Monitor common alert schema. Posts a formatted summary to the channel given by ?channel= (defaults to #feed-errors).",
+        "operationId": "ReceiveAzureAlert",
+        "parameters": [
+          {
+            "name": "channel",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Slack channel including the leading # (defaults to #feed-errors)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Alert relayed",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/routing": {
+      "get": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Get notification routing",
+        "description": "Returns the tenant's notification routing plus the known keys and active chat provider.",
+        "operationId": "GetNotificationRouting",
+        "responses": {
+          "200": {
+            "description": "Payload of NotificationRoutingResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/notificationRoutingResponse"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Update notification routing",
+        "description": "Upserts the tenant's notification routing (routes + default destination).",
+        "operationId": "UpdateNotificationRouting",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/updateNotificationRoutingRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No description",
+            "x-ms-summary": "Saved"
+          },
+          "400": {
+            "description": "No description",
+            "x-ms-summary": "Invalid body"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/protected/push/register": {
       "post": {
         "tags": [
@@ -39,8 +256,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -62,8 +282,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -96,8 +319,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -130,8 +356,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -164,8 +393,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -198,8 +430,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -232,8 +467,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -255,8 +493,11 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -285,11 +526,63 @@
         "security": [
           {
             "Implicit": [
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
             ]
           }
         ]
       }
+    },
+    "/v1.0/protected/time-logging/reminder/trigger": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Trigger the time-logging SMS reminder",
+        "description": "Manually runs the personal time-logging SMS reminder for the calling tenant: texts active employees who have not yet locked their hours for the current month. Ignores the last-day-of-month gate.",
+        "operationId": "TriggerTimeLoggingReminder",
+        "responses": {
+          "200": {
+            "description": "Reminder run completed",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/time-logging/shame/trigger": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Trigger the monthly time-logging shame",
+        "description": "Manually runs the monthly time-logging shame for the calling tenant: reads employees without all hours approved for last month from accounting/PowerOffice and posts the public reminder to #general.",
+        "operationId": "TriggerTimeLoggingShame",
+        "responses": {
+          "200": {
+            "description": "Shame run completed",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
     }
   },
   "components": {
@@ -314,6 +607,71 @@
           }
         }
       },
+      "integrationHealthResult": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      },
+      "notificationKnownKeyDto": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "group": {
+            "type": "string"
+          }
+        }
+      },
+      "notificationRouteDto": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "destination": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          }
+        }
+      },
+      "notificationRoutingResponse": {
+        "type": "object",
+        "properties": {
+          "routes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/notificationRouteDto"
+            }
+          },
+          "defaultDestination": {
+            "type": "string"
+          },
+          "knownKeys": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/notificationKnownKeyDto"
+            }
+          },
+          "activeChatProvider": {
+            "type": "string"
+          }
+        }
+      },
       "sendEmailAttachmentRequest": {
         "type": "object",
         "properties": {
@@ -442,6 +800,20 @@
             "type": "string"
           }
         }
+      },
+      "updateNotificationRoutingRequest": {
+        "type": "object",
+        "properties": {
+          "routes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/notificationRouteDto"
+            }
+          },
+          "defaultDestination": {
+            "type": "string"
+          }
+        }
       }
     },
     "securitySchemes": {
@@ -449,14 +821,19 @@
         "type": "oauth2",
         "flows": {
           "implicit": {
-            "authorizationUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/authorize",
-            "tokenUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
-            "refreshUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
+            "authorizationUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize",
+            "tokenUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/token",
+            "refreshUrl": "https://login.microsoftonline.com/organizations/oauth2/v2.0/token",
             "scopes": {
-              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/.default": "Default function scope"
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default": "Default function scope"
             }
           }
         }
+      },
+      "ApiKey": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT"
       }
     }
   }