@novu/api 3.12.0-rc.0 → 3.13.0

package/sources/json-development.json

@@ -3023,7 +3023,9 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/"
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Generic webhook payload from delivery providers"
               }
             }
           }
@@ -9506,6 +9508,21 @@
               "type": "string"
             }
           },
+          {
+            "name": "contextKeys",
+            "required": false,
+            "in": "query",
+            "description": "Context keys for filtering preferences (e.g., [\"tenant:acme\"])",
+            "example": [
+              "tenant:acme"
+            ],
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
           {
             "name": "idempotency-key",
             "in": "header",
@@ -11052,6 +11069,22 @@
               "type": "string"
             }
           },
+          {
+            "name": "contextKeys",
+            "required": false,
+            "in": "query",
+            "description": "Filter by exact context keys, order insensitive (format: \"type:id\")",
+            "example": [
+              "tenant:org-123",
+              "region:us-east-1"
+            ],
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
           {
             "name": "idempotency-key",
             "in": "header",
@@ -13577,11 +13610,496 @@
             "secretKey": []
           }
         ]
-      },
-      "delete": {
-        "operationId": "TopicsController_deleteTopic",
-        "summary": "Delete a topic",
-        "description": "Delete a topic by its unique key identifier **topicKey**. \n    This action is irreversible and will remove all subscriptions to the topic.",
+      },
+      "delete": {
+        "operationId": "TopicsController_deleteTopic",
+        "summary": "Delete a topic",
+        "description": "Delete a topic by its unique key identifier **topicKey**. \n    This action is irreversible and will remove all subscriptions to the topic.",
+        "parameters": [
+          {
+            "name": "topicKey",
+            "required": true,
+            "in": "path",
+            "description": "The key identifier of the topic",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "idempotency-key",
+            "in": "header",
+            "description": "A header for idempotency purposes",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Topic deleted successfully",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteTopicResponseDto"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not Found",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "405": {
+            "description": "Method Not Allowed",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "413": {
+            "description": "Payload Too Large",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "414": {
+            "description": "URI Too Long",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "415": {
+            "description": "Unsupported Media Type",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Unprocessable Entity",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidationErrorDto"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "The client has sent too many requests in a given amount of time. ",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              },
+              "Retry-After": {
+                "$ref": "#/components/headers/Retry-After"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string",
+                  "example": "API rate limit exceeded"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorDto"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "The server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay.",
+            "headers": {
+              "Content-Type": {
+                "$ref": "#/components/headers/Content-Type"
+              },
+              "RateLimit-Limit": {
+                "$ref": "#/components/headers/RateLimit-Limit"
+              },
+              "RateLimit-Remaining": {
+                "$ref": "#/components/headers/RateLimit-Remaining"
+              },
+              "RateLimit-Reset": {
+                "$ref": "#/components/headers/RateLimit-Reset"
+              },
+              "RateLimit-Policy": {
+                "$ref": "#/components/headers/RateLimit-Policy"
+              },
+              "Idempotency-Key": {
+                "$ref": "#/components/headers/Idempotency-Key"
+              },
+              "Idempotency-Replay": {
+                "$ref": "#/components/headers/Idempotency-Replay"
+              },
+              "Retry-After": {
+                "$ref": "#/components/headers/Retry-After"
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string",
+                  "example": "Please wait some time, then try again."
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Topics"
+        ],
+        "security": [
+          {
+            "secretKey": []
+          }
+        ]
+      }
+    },
+    "/v2/topics/{topicKey}/subscriptions": {
+      "get": {
+        "operationId": "TopicsController_listTopicSubscriptions",
+        "x-speakeasy-group": "Topics.Subscriptions",
+        "summary": "List topic subscriptions",
+        "description": "List all subscriptions of subscribers for a topic.\n    Checkout all available filters in the query section.",
         "parameters": [
           {
             "name": "topicKey",
@@ -13592,6 +14110,91 @@
               "type": "string"
             }
           },
+          {
+            "name": "after",
+            "required": false,
+            "in": "query",
+            "description": "Cursor for pagination indicating the starting point after which to fetch results.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "before",
+            "required": false,
+            "in": "query",
+            "description": "Cursor for pagination indicating the ending point before which to fetch results.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "required": false,
+            "in": "query",
+            "description": "Limit the number of items to return (max 100)",
+            "example": 10,
+            "schema": {
+              "maximum": 100,
+              "type": "number"
+            }
+          },
+          {
+            "name": "orderDirection",
+            "required": false,
+            "in": "query",
+            "description": "Direction of sorting",
+            "schema": {
+              "enum": [
+                "ASC",
+                "DESC"
+              ],
+              "type": "string"
+            }
+          },
+          {
+            "name": "orderBy",
+            "required": false,
+            "in": "query",
+            "description": "Field to order by",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "includeCursor",
+            "required": false,
+            "in": "query",
+            "description": "Include cursor item in response",
+            "schema": {
+              "type": "boolean"
+            }
+          },
+          {
+            "name": "subscriberId",
+            "required": false,
+            "in": "query",
+            "description": "Filter by subscriber ID",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "contextKeys",
+            "required": false,
+            "in": "query",
+            "description": "Filter by exact context keys, order insensitive (format: \"type:id\")",
+            "example": [
+              "tenant:org-123",
+              "region:us-east-1"
+            ],
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
           {
             "name": "idempotency-key",
             "in": "header",
@@ -13604,7 +14207,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Topic deleted successfully",
+            "description": "OK",
             "headers": {
               "Content-Type": {
                 "$ref": "#/components/headers/Content-Type"
@@ -13631,7 +14234,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/DeleteTopicResponseDto"
+                  "$ref": "#/components/schemas/ListTopicSubscriptionsResponseDto"
                 }
               }
             }
@@ -14059,14 +14662,13 @@
             "secretKey": []
           }
         ]
-      }
-    },
-    "/v2/topics/{topicKey}/subscriptions": {
-      "get": {
-        "operationId": "TopicsController_listTopicSubscriptions",
+      },
+      "post": {
+        "operationId": "TopicsController_createTopicSubscriptions",
+        "x-speakeasy-name-override": "create",
         "x-speakeasy-group": "Topics.Subscriptions",
-        "summary": "List topic subscriptions",
-        "description": "List all subscriptions of subscribers for a topic.\n    Checkout all available filters in the query section.",
+        "summary": "Create topic subscriptions",
+        "description": "This api will create subscription for subscriberIds for a topic. \n      Its like subscribing to a common interest group. if topic does not exist, it will be created.",
         "parameters": [
           {
             "name": "topicKey",
@@ -14077,75 +14679,6 @@
               "type": "string"
             }
           },
-          {
-            "name": "after",
-            "required": false,
-            "in": "query",
-            "description": "Cursor for pagination indicating the starting point after which to fetch results.",
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "before",
-            "required": false,
-            "in": "query",
-            "description": "Cursor for pagination indicating the ending point before which to fetch results.",
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "limit",
-            "required": false,
-            "in": "query",
-            "description": "Limit the number of items to return (max 100)",
-            "example": 10,
-            "schema": {
-              "maximum": 100,
-              "type": "number"
-            }
-          },
-          {
-            "name": "orderDirection",
-            "required": false,
-            "in": "query",
-            "description": "Direction of sorting",
-            "schema": {
-              "enum": [
-                "ASC",
-                "DESC"
-              ],
-              "type": "string"
-            }
-          },
-          {
-            "name": "orderBy",
-            "required": false,
-            "in": "query",
-            "description": "Field to order by",
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "includeCursor",
-            "required": false,
-            "in": "query",
-            "description": "Include cursor item in response",
-            "schema": {
-              "type": "boolean"
-            }
-          },
-          {
-            "name": "subscriberId",
-            "required": false,
-            "in": "query",
-            "description": "Filter by subscriber ID",
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "name": "idempotency-key",
             "in": "header",
@@ -14156,9 +14689,19 @@
             }
           }
         ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateTopicSubscriptionsRequestDto"
+              }
+            }
+          }
+        },
         "responses": {
-          "200": {
-            "description": "OK",
+          "201": {
+            "description": "Subscriptions created successfully",
             "headers": {
               "Content-Type": {
                 "$ref": "#/components/headers/Content-Type"
@@ -14185,7 +14728,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ListTopicSubscriptionsResponseDto"
+                  "$ref": "#/components/schemas/CreateSubscriptionsResponseDto"
                 }
               }
             }
@@ -14614,12 +15157,12 @@
           }
         ]
       },
-      "post": {
-        "operationId": "TopicsController_createTopicSubscriptions",
-        "x-speakeasy-name-override": "create",
+      "delete": {
+        "operationId": "TopicsController_deleteTopicSubscriptions",
+        "x-speakeasy-name-override": "delete",
         "x-speakeasy-group": "Topics.Subscriptions",
-        "summary": "Create topic subscriptions",
-        "description": "This api will create subscription for subscriberIds for a topic. \n      Its like subscribing to a common interest group. if topic does not exist, it will be created.",
+        "summary": "Delete topic subscriptions",
+        "description": "Delete subscriptions for subscriberIds for a topic.",
         "parameters": [
           {
             "name": "topicKey",
@@ -14645,14 +15188,14 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/CreateTopicSubscriptionsRequestDto"
+                "$ref": "#/components/schemas/DeleteTopicSubscriptionsRequestDto"
               }
             }
           }
         },
         "responses": {
-          "201": {
-            "description": "Subscriptions created successfully",
+          "200": {
+            "description": "Subscriptions deleted successfully",
             "headers": {
               "Content-Type": {
                 "$ref": "#/components/headers/Content-Type"
@@ -14679,7 +15222,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CreateSubscriptionsResponseDto"
+                  "$ref": "#/components/schemas/DeleteTopicSubscriptionsResponseDto"
                 }
               }
             }
@@ -15107,13 +15650,15 @@
             "secretKey": []
           }
         ]
-      },
-      "delete": {
-        "operationId": "TopicsController_deleteTopicSubscriptions",
-        "x-speakeasy-name-override": "delete",
+      }
+    },
+    "/v2/topics/{topicKey}/subscriptions/{identifier}": {
+      "get": {
+        "operationId": "TopicsController_getTopicSubscription",
+        "x-speakeasy-name-override": "getSubscription",
         "x-speakeasy-group": "Topics.Subscriptions",
-        "summary": "Delete topic subscriptions",
-        "description": "Delete subscriptions for subscriberIds for a topic.",
+        "summary": "Get a topic subscription",
+        "description": "Get a subscription by its unique identifier for a topic.",
         "parameters": [
           {
             "name": "topicKey",
@@ -15124,6 +15669,15 @@
               "type": "string"
             }
           },
+          {
+            "name": "identifier",
+            "required": true,
+            "in": "path",
+            "description": "The unique identifier of the subscription",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "idempotency-key",
             "in": "header",
@@ -15134,19 +15688,9 @@
             }
           }
         ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/DeleteTopicSubscriptionsRequestDto"
-              }
-            }
-          }
-        },
         "responses": {
           "200": {
-            "description": "Subscriptions deleted successfully",
+            "description": "OK",
             "headers": {
               "Content-Type": {
                 "$ref": "#/components/headers/Content-Type"
@@ -15173,7 +15717,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/DeleteTopicSubscriptionsResponseDto"
+                  "$ref": "#/components/schemas/SubscriptionDetailsResponseDto"
                 }
               }
             }
@@ -15601,15 +16145,13 @@
             "secretKey": []
           }
         ]
-      }
-    },
-    "/v2/topics/{topicKey}/subscriptions/{subscriptionIdOrIdentifier}": {
+      },
       "patch": {
         "operationId": "TopicsController_updateTopicSubscription",
         "x-speakeasy-name-override": "update",
         "x-speakeasy-group": "Topics.Subscriptions",
         "summary": "Update a topic subscription",
-        "description": "Update a subscription by its unique identifier **subscriptionIdOrIdentifier** for a topic. You can update the preferences and name associated with the subscription.",
+        "description": "Update a subscription by its unique identifier for a topic. You can update the preferences and name associated with the subscription.",
         "parameters": [
           {
             "name": "topicKey",
@@ -15621,7 +16163,7 @@
             }
           },
           {
-            "name": "subscriptionIdOrIdentifier",
+            "name": "identifier",
             "required": true,
             "in": "path",
             "description": "The unique identifier of the subscription",
@@ -20636,8 +21178,9 @@
     "/v1/channel-connections": {
       "get": {
         "operationId": "ChannelConnectionsController_listChannelConnections",
-        "summary": "List channel connections",
-        "description": "Retrieve all channel connections for a resource.",
+        "x-speakeasy-name-override": "list",
+        "summary": "List all channel connections",
+        "description": "List all channel connections for a resource.",
         "parameters": [
           {
             "name": "after",
@@ -21232,7 +21775,8 @@
       },
       "post": {
         "operationId": "ChannelConnectionsController_createChannelConnection",
-        "summary": "Create channel connection for a resource and integration",
+        "x-speakeasy-name-override": "create",
+        "summary": "Create a channel connection",
         "description": "Create a new channel connection for a resource for given integration. Only one channel connection is allowed per resource and integration.",
         "parameters": [
           {
@@ -21717,7 +22261,8 @@
     "/v1/channel-connections/{identifier}": {
       "get": {
         "operationId": "ChannelConnectionsController_getChannelConnectionByIdentifier",
-        "summary": "Retrieve channel connection by identifier",
+        "x-speakeasy-name-override": "retrieve",
+        "summary": "Retrieve a channel connection",
         "description": "Retrieve a specific channel connection by its unique identifier.",
         "parameters": [
           {
@@ -22199,7 +22744,8 @@
       },
       "patch": {
         "operationId": "ChannelConnectionsController_updateChannelConnection",
-        "summary": "Update channel connection",
+        "x-speakeasy-name-override": "update",
+        "summary": "Update a channel connection",
         "description": "Update an existing channel connection by its unique identifier.",
         "parameters": [
           {
@@ -22691,7 +23237,8 @@
       },
       "delete": {
         "operationId": "ChannelConnectionsController_deleteChannelConnection",
-        "summary": "Delete channel connection",
+        "x-speakeasy-name-override": "delete",
+        "summary": "Delete a channel connection",
         "description": "Delete a specific channel connection by its unique identifier.",
         "parameters": [
           {
@@ -23145,8 +23692,9 @@
     "/v1/channel-endpoints": {
       "get": {
         "operationId": "ChannelEndpointsController_listChannelEndpoints",
-        "summary": "List channel endpoints",
-        "description": "Retrieve all channel endpoints for a resource based on query filters.",
+        "x-speakeasy-name-override": "list",
+        "summary": "List all channel endpoints",
+        "description": "List all channel endpoints for a resource based on query filters.",
         "parameters": [
           {
             "name": "after",
@@ -23753,7 +24301,8 @@
       },
       "post": {
         "operationId": "ChannelEndpointsController_createChannelEndpoint",
-        "summary": "Create channel endpoint for a resource",
+        "x-speakeasy-name-override": "create",
+        "summary": "Create a channel endpoint",
         "description": "Create a new channel endpoint for a resource.",
         "parameters": [
           {
@@ -24272,7 +24821,8 @@
     "/v1/channel-endpoints/{identifier}": {
       "get": {
         "operationId": "ChannelEndpointsController_getChannelEndpoint",
-        "summary": "Retrieve channel endpoint by identifier",
+        "x-speakeasy-name-override": "retrieve",
+        "summary": "Retrieve a channel endpoint",
         "description": "Retrieve a specific channel endpoint by its unique identifier.",
         "parameters": [
           {
@@ -24757,7 +25307,8 @@
       },
       "patch": {
         "operationId": "ChannelEndpointsController_updateChannelEndpoint",
-        "summary": "Update channel endpoint",
+        "x-speakeasy-name-override": "update",
+        "summary": "Update a channel endpoint",
         "description": "Update an existing channel endpoint by its unique identifier.",
         "parameters": [
           {
@@ -25252,7 +25803,8 @@
       },
       "delete": {
         "operationId": "ChannelEndpointsController_deleteChannelEndpoint",
-        "summary": "Delete channel endpoint by identifier",
+        "x-speakeasy-name-override": "delete",
+        "summary": "Delete a channel endpoint",
         "description": "Delete a specific channel endpoint by its unique identifier.",
         "parameters": [
           {
@@ -27640,7 +28192,7 @@
         },
         "x-speakeasy-name-override": "trigger",
         "summary": "Trigger event",
-        "description": "\n    Trigger event is the main (and only) way to send notifications to subscribers. The trigger identifier is used to match the particular workflow associated with it. Additional information can be passed according the body interface below.\n    To prevent duplicate triggers, you can optionally pass a **transactionId** in the request body. If the same **transactionId** is used again, the trigger will be ignored. The retention period depends on your billing tier.",
+        "description": "\n    Trigger event is the main (and only) way to send notifications to subscribers. The trigger identifier is used to match the particular workflow associated with it. Maximum number of recipients can be 100. Additional information can be passed according the body interface below.\n    To prevent duplicate triggers, you can optionally pass a **transactionId** in the request body. If the same **transactionId** is used again, the trigger will be ignored. The retention period depends on your billing tier.",
         "parameters": [
           {
             "name": "idempotency-key",
@@ -35105,6 +35657,15 @@
               "type": "string"
             }
           },
+          {
+            "name": "subscriptionId",
+            "required": false,
+            "in": "query",
+            "description": "Subscription ID for filtering notifications by subscription",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "contextKeys",
             "required": false,
@@ -41576,7 +42137,7 @@
   "info": {
     "title": "Novu API",
     "description": "Novu REST API. Please see https://docs.novu.co/api-reference for more details.",
-    "version": "3.11.0",
+    "version": "3.12.0",
     "contact": {
       "name": "Novu Support",
       "url": "https://discord.gg/novu",
@@ -42671,7 +43232,7 @@
             ]
           },
           "to": {
-            "description": "The recipients list of people who will receive the notification.",
+            "description": "The recipients list of people who will receive the notification. Maximum number of recipients can be 100.",
             "oneOf": [
               {
                 "type": "array",
@@ -43991,6 +44552,40 @@
           "traces"
         ]
       },
+      "TopicResponseDto": {
+        "type": "object",
+        "properties": {
+          "_id": {
+            "type": "string",
+            "description": "The identifier of the topic",
+            "example": "64da692e9a94fb2e6449ad06"
+          },
+          "key": {
+            "type": "string",
+            "description": "The unique key of the topic",
+            "example": "product-updates"
+          },
+          "name": {
+            "type": "string",
+            "description": "The name of the topic",
+            "example": "Product Updates"
+          },
+          "createdAt": {
+            "type": "string",
+            "description": "The date the topic was created",
+            "example": "2023-08-15T00:00:00.000Z"
+          },
+          "updatedAt": {
+            "type": "string",
+            "description": "The date the topic was last updated",
+            "example": "2023-08-15T00:00:00.000Z"
+          }
+        },
+        "required": [
+          "_id",
+          "key"
+        ]
+      },
       "WorkflowRunStepsDetailsDto": {
         "type": "object",
         "properties": {
@@ -44120,6 +44715,13 @@
               "type": "string"
             }
           },
+          "topics": {
+            "description": "Topics",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TopicResponseDto"
+            }
+          },
           "steps": {
             "description": "Workflow run steps",
             "type": "array",
@@ -44370,6 +44972,13 @@
               "type": "string"
             }
           },
+          "topics": {
+            "description": "Topics",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TopicResponseDto"
+            }
+          },
           "steps": {
             "description": "Step runs",
             "type": "array",
@@ -44807,7 +45416,8 @@
           },
           "connectionIdentifier": {
             "type": "string",
-            "description": "Identifier of the channel connection that will be created"
+            "description": "Identifier of the channel connection that will be created. It is generated automatically if not provided.",
+            "example": "slack-connection-abc123"
           },
           "context": {
             "type": "object",
@@ -45500,7 +46110,8 @@
         "properties": {
           "payload": {
             "type": "object",
-            "description": "Payload of the action result"
+            "description": "Payload of the action result",
+            "additionalProperties": true
           },
           "type": {
             "$ref": "#/components/schemas/ButtonTypeEnum"
@@ -45730,6 +46341,11 @@
             "description": "Indicates whether the notification has been seen by the subscriber.",
             "example": true
           },
+          "archived": {
+            "type": "boolean",
+            "description": "Indicates whether the notification has been archived by the subscriber.",
+            "example": false
+          },
           "deviceTokens": {
             "nullable": true,
             "description": "Device tokens for push notifications, if applicable.",
@@ -45811,6 +46427,7 @@
           "channel",
           "read",
           "seen",
+          "archived",
           "cta",
           "status"
         ]
@@ -46581,11 +47198,13 @@
           },
           "payload": {
             "type": "object",
-            "description": "The payload that was used to send the notification trigger"
+            "description": "The payload that was used to send the notification trigger",
+            "additionalProperties": true
           },
           "overrides": {
             "type": "object",
-            "description": "Provider specific overrides used when triggering the notification"
+            "description": "Provider specific overrides used when triggering the notification",
+            "additionalProperties": true
           },
           "contextKeys": {
             "description": "Context (single or multi) in which the message was sent",
@@ -47168,6 +47787,10 @@
                 "$ref": "#/components/schemas/SubscriberPreferencesWorkflowInfoDto"
               }
             ]
+          },
+          "updatedAt": {
+            "type": "string",
+            "description": "Timestamp when the subscriber last updated their preference. Only present if subscriber explicitly set preferences."
           }
         },
         "required": [
@@ -47359,6 +47982,40 @@
             "items": {
               "$ref": "#/components/schemas/BulkUpdateSubscriberPreferenceItemDto"
             }
+          },
+          "context": {
+            "type": "object",
+            "additionalProperties": {
+              "oneOf": [
+                {
+                  "type": "string",
+                  "description": "Simple context id",
+                  "example": "org-acme"
+                },
+                {
+                  "type": "object",
+                  "description": "Rich context object with id and optional data",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "example": "org-acme"
+                    },
+                    "data": {
+                      "type": "object",
+                      "description": "Optional additional context data",
+                      "additionalProperties": true,
+                      "example": {
+                        "name": "Acme Corp",
+                        "region": "us-east-1"
+                      }
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ]
+                }
+              ]
+            }
           }
         },
         "required": [
@@ -47387,42 +48044,42 @@
                 "$ref": "#/components/schemas/ScheduleDto"
               }
             ]
-          }
-        }
-      },
-      "TopicResponseDto": {
-        "type": "object",
-        "properties": {
-          "_id": {
-            "type": "string",
-            "description": "The identifier of the topic",
-            "example": "64da692e9a94fb2e6449ad06"
-          },
-          "key": {
-            "type": "string",
-            "description": "The unique key of the topic",
-            "example": "product-updates"
-          },
-          "name": {
-            "type": "string",
-            "description": "The name of the topic",
-            "example": "Product Updates"
-          },
-          "createdAt": {
-            "type": "string",
-            "description": "The date the topic was created",
-            "example": "2023-08-15T00:00:00.000Z"
           },
-          "updatedAt": {
-            "type": "string",
-            "description": "The date the topic was last updated",
-            "example": "2023-08-15T00:00:00.000Z"
+          "context": {
+            "type": "object",
+            "additionalProperties": {
+              "oneOf": [
+                {
+                  "type": "string",
+                  "description": "Simple context id",
+                  "example": "org-acme"
+                },
+                {
+                  "type": "object",
+                  "description": "Rich context object with id and optional data",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "example": "org-acme"
+                    },
+                    "data": {
+                      "type": "object",
+                      "description": "Optional additional context data",
+                      "additionalProperties": true,
+                      "example": {
+                        "name": "Acme Corp",
+                        "region": "us-east-1"
+                      }
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ]
+                }
+              ]
+            }
           }
-        },
-        "required": [
-          "_id",
-          "key"
-        ]
+        }
       },
       "SubscriberDto": {
         "type": "object",
@@ -47475,6 +48132,11 @@
             "description": "The identifier of the subscription",
             "example": "64da692e9a94fb2e6449ad08"
           },
+          "identifier": {
+            "type": "string",
+            "description": "The identifier of the subscription",
+            "example": "tk=product-updates:si=subscriber-123"
+          },
           "createdAt": {
             "type": "string",
             "description": "The date and time the subscription was created",
@@ -47495,10 +48157,22 @@
                 "$ref": "#/components/schemas/SubscriberDto"
               }
             ]
+          },
+          "contextKeys": {
+            "description": "Context keys that scope this subscription (e.g., tenant:org-a, project:proj-123)",
+            "example": [
+              "tenant:org-a",
+              "project:proj-123"
+            ],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
           "_id",
+          "identifier",
           "createdAt",
           "topic",
           "subscriber"
@@ -48450,6 +49124,17 @@
               "$ref": "#/components/schemas/SubscriptionPreferenceDto"
             }
           },
+          "contextKeys": {
+            "description": "Context keys that scope this subscription (e.g., tenant:org-a, project:proj-123)",
+            "example": [
+              "tenant:org-a",
+              "project:proj-123"
+            ],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
           "createdAt": {
             "type": "string",
             "description": "The creation date of the subscription",
@@ -48718,6 +49403,40 @@
             "description": "The name of the topic",
             "example": "My Topic"
           },
+          "context": {
+            "type": "object",
+            "additionalProperties": {
+              "oneOf": [
+                {
+                  "type": "string",
+                  "description": "Simple context id",
+                  "example": "org-acme"
+                },
+                {
+                  "type": "object",
+                  "description": "Rich context object with id and optional data",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "example": "org-acme"
+                    },
+                    "data": {
+                      "type": "object",
+                      "description": "Optional additional context data",
+                      "additionalProperties": true,
+                      "example": {
+                        "name": "Acme Corp",
+                        "region": "us-east-1"
+                      }
+                    }
+                  },
+                  "required": [
+                    "id"
+                  ]
+                }
+              ]
+            }
+          },
           "preferences": {
             "type": "array",
             "description": "The preferences of the topic. Can be a simple workflow ID string, workflow preference object, or group filter object",
@@ -48780,6 +49499,17 @@
               }
             ]
           },
+          "contextKeys": {
+            "description": "Context keys that scope this subscription (e.g., tenant:org-a, project:proj-123)",
+            "example": [
+              "tenant:org-a",
+              "project:proj-123"
+            ],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
           "createdAt": {
             "type": "string",
             "description": "The creation date of the subscription",
@@ -48913,6 +49643,47 @@
           }
         }
       },
+      "SubscriptionDetailsResponseDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The unique identifier of the subscription",
+            "example": "64f5e95d3d7946d80d0cb679"
+          },
+          "identifier": {
+            "type": "string",
+            "description": "The identifier of the subscription",
+            "example": "subscription-identifier"
+          },
+          "name": {
+            "type": "string",
+            "description": "The name of the subscription",
+            "example": "My Subscription"
+          },
+          "preferences": {
+            "description": "The preferences/rules for the subscription",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SubscriptionPreferenceDto"
+            }
+          },
+          "contextKeys": {
+            "description": "Context keys that scope this subscription (e.g., tenant:org-a, project:proj-123)",
+            "example": [
+              "tenant:org-a",
+              "project:proj-123"
+            ],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "id"
+        ]
+      },
       "UpdateTopicSubscriptionRequestDto": {
         "type": "object",
         "properties": {
@@ -50987,7 +51758,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51024,7 +51795,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51061,7 +51832,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51098,7 +51869,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51135,7 +51906,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51172,7 +51943,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51209,7 +51980,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51246,7 +52017,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51283,7 +52054,7 @@
           },
           "stepId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the step"
           },
           "name": {
@@ -51391,7 +52162,7 @@
           },
           "workflowId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Unique identifier for the workflow"
           },
           "steps": {
@@ -51747,7 +52518,7 @@
           },
           "workflowId": {
             "type": "string",
-            "pattern": "/^[a-z0-9]+(?:-[a-z0-9]+)*$/",
+            "pattern": "/^[a-zA-Z0-9]+(?:[-_][a-zA-Z0-9]+)*$/",
             "description": "Custom workflow identifier for the duplicated workflow"
           },
           "tags": {