@snokam/mcp-api 1.4.0 → 1.4.1

package/specs/production/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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/protected/push/register": {
       "post": {
         "tags": [
@@ -39,8 +256,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -62,8 +282,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -96,8 +319,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -130,8 +356,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -164,8 +393,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -198,8 +430,11 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -232,8 +467,119 @@
         "security": [
           {
             "Implicit": [
-              "api://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/sprint-notification/trigger": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Trigger weekly sprint summary",
+        "description": "Manually triggers the weekly sprint summary notification to Slack #general",
+        "operationId": "TriggerSprintNotification",
+        "responses": {
+          "200": {
+            "description": "Summary sent successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/sprint-notification/debug": {
+      "get": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Debug friday summary",
+        "description": "Returns the full friday summary including ChatGPT output for debugging",
+        "operationId": "DebugSprintSummary",
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Debug data"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.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://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
             ]
+          },
+          {
+            "ApiKey": []
           }
         ]
       }
@@ -261,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": {
@@ -389,6 +800,20 @@
             "type": "string"
           }
         }
+      },
+      "updateNotificationRoutingRequest": {
+        "type": "object",
+        "properties": {
+          "routes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/notificationRouteDto"
+            }
+          },
+          "defaultDestination": {
+            "type": "string"
+          }
+        }
       }
     },
     "securitySchemes": {
@@ -396,14 +821,19 @@
         "type": "oauth2",
         "flows": {
           "implicit": {
-            "authorizationUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/oauth2/v2.0/authorize",
-            "tokenUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/oauth2/v2.0/token",
-            "refreshUrl": "https://login.microsoftonline.com/81a4f38d-6712-4b65-868b-c3771f9ba91e/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://46c59afb-0021-439b-a56c-6e29d39f2c7a/.default": "Default function scope"
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default": "Default function scope"
             }
           }
         }
+      },
+      "ApiKey": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT"
       }
     }
   }