@botpress/api 1.71.0 → 1.72.0

package/dist/index.js

@@ -279445,7 +279445,7 @@ var state = {
     "title": "Botpress Runtime API",
     "description": "API for Botpress Runtime",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v1"
   },
   "defaultParameters": {
@@ -281242,6 +281242,11 @@ var state2 = {
                   "maxLength": 2e3,
                   "description": "URL of the [Integration](#schema_integration)"
                 },
+                "signingSecret": {
+                  "type": "string",
+                  "maxLength": 2e3,
+                  "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+                },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
@@ -281885,6 +281890,7 @@ var state2 = {
                 "updatedAt",
                 "identifier",
                 "url",
+                "signingSecret",
                 "name",
                 "version",
                 "interfaces",
@@ -282016,6 +282022,11 @@ var state2 = {
                   "maxLength": 2e3,
                   "description": "URL of the [Integration](#schema_integration)"
                 },
+                "signingSecret": {
+                  "type": "string",
+                  "maxLength": 2e3,
+                  "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+                },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
@@ -282659,6 +282670,7 @@ var state2 = {
                 "updatedAt",
                 "identifier",
                 "url",
+                "signingSecret",
                 "name",
                 "version",
                 "interfaces",
@@ -285316,9 +285328,10 @@ var state2 = {
             "authentication": {
               "type": "string",
               "enum": [
-                "iam"
+                "iam",
+                "hmac-sha256"
               ],
-              "description": "Type of the [Bot](#schema_bot) authentication (`iam`)"
+              "description": "Type of the [Bot](#schema_bot) authentication (`iam` or `hmac-sha256`)"
             },
             "configuration": {
               "type": "object",
@@ -285795,6 +285808,60 @@ var state2 = {
         "documented"
       ]
     },
+    "rotateBotSigningSecrets": {
+      "name": "rotateBotSigningSecrets",
+      "description": "Rotate bot signing secrets. This will generate a new signing secret and invalidate the old ones after 24 hours.",
+      "method": "post",
+      "section": "bot",
+      "path": "/v1/admin/bots/{id}/signing-secrets/rotate",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Bot ID",
+          "in": "path"
+        },
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        },
+        "x-multiple-integrations": {
+          "in": "header",
+          "type": "string",
+          "description": 'Whether the client supports bots with multiple instances of the same integration. Set to "true" to receive integration instances keyed by their alias instead of their id. This header will be removed in the future, and the API will always return multiple instances keyed by alias.',
+          "required": false
+        }
+      },
+      "requestBody": {
+        "description": "Empty body",
+        "schema": {
+          "type": "object",
+          "title": "rotateBotSigningSecretsBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Success",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "newSigningSecret": {
+              "type": "string",
+              "description": "The new signing secret that can be used immediately. The old signing secret(s) will continue to work for 24 hours after this operation to allow for a smooth transition."
+            }
+          },
+          "required": [
+            "newSigningSecret"
+          ],
+          "title": "rotateBotSigningSecretsResponse",
+          "additionalProperties": false
+        }
+      },
+      "tags": [
+        "experimental"
+      ]
+    },
     "transferBot": {
       "name": "transferBot",
       "description": "Transfer bot to another workspace. You need to be a Manager member of the workspace the bot currently belongs to and have permission to create bots in the target workspace.",
@@ -292080,6 +292147,60 @@ var state2 = {
         "documented"
       ]
     },
+    "rotateIntegrationSigningSecrets": {
+      "name": "rotateIntegrationSigningSecrets",
+      "description": "Rotate integration signing secrets. This will generate a new signing secret and invalidate the old ones after 24 hours.",
+      "method": "post",
+      "section": "integration",
+      "path": "/v1/admin/integrations/{id}/signing-secrets/rotate",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Integration Version ID",
+          "in": "path"
+        },
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        },
+        "x-multiple-integrations": {
+          "in": "header",
+          "type": "string",
+          "description": 'Whether the client supports bots with multiple instances of the same integration. Set to "true" to receive integration instances keyed by their alias instead of their id. This header will be removed in the future, and the API will always return multiple instances keyed by alias.',
+          "required": false
+        }
+      },
+      "requestBody": {
+        "description": "Empty body",
+        "schema": {
+          "type": "object",
+          "title": "rotateIntegrationSigningSecretsBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Success",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "newSigningSecret": {
+              "type": "string",
+              "description": "The new signing secret that can be used immediately. The old signing secret(s) will continue to work for 24 hours after this operation to allow for a smooth transition."
+            }
+          },
+          "required": [
+            "newSigningSecret"
+          ],
+          "title": "rotateIntegrationSigningSecretsResponse",
+          "additionalProperties": false
+        }
+      },
+      "tags": [
+        "experimental"
+      ]
+    },
     "validateIntegrationUpdate": {
       "name": "validateIntegrationUpdate",
       "description": "Perform a validation of an integration update request",
@@ -295871,7 +295992,7 @@ var state2 = {
     "title": "Botpress Admin API",
     "description": "API for Botpress Cloud Manager",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v1"
   },
   "defaultParameters": {
@@ -296030,6 +296151,7 @@ var state2 = {
       "setAccountPreferenceBody": true,
       "createBotBody": true,
       "updateBotBody": true,
+      "rotateBotSigningSecretsBody": true,
       "transferBotBody": true,
       "publishFromBotJsonBody": true,
       "createBotVersionBody": true,
@@ -296048,6 +296170,7 @@ var state2 = {
       "createIntegrationBody": true,
       "validateIntegrationCreationBody": true,
       "updateIntegrationBody": true,
+      "rotateIntegrationSigningSecretsBody": true,
       "validateIntegrationUpdateBody": true,
       "requestIntegrationVerificationBody": true,
       "createInterfaceBody": true,
@@ -296080,6 +296203,7 @@ var state2 = {
       "getPublicInterfaceResponse": true,
       "createBotResponse": true,
       "updateBotResponse": true,
+      "rotateBotSigningSecretsResponse": true,
       "transferBotResponse": true,
       "listBotsResponse": true,
       "getBotResponse": true,
@@ -296137,6 +296261,7 @@ var state2 = {
       "createIntegrationResponse": true,
       "validateIntegrationCreationResponse": true,
       "updateIntegrationResponse": true,
+      "rotateIntegrationSigningSecretsResponse": true,
       "validateIntegrationUpdateResponse": true,
       "listIntegrationsResponse": true,
       "getIntegrationResponse": true,
@@ -296207,7 +296332,7 @@ var state2 = {
           "signingSecret": {
             "type": "string",
             "maxLength": 2e3,
-            "description": "Signing secret of the [Bot](#schema_bot)"
+            "description": "Signing secret of the [Bot](#schema_bot). This field is only visible when creating a new bot or when rotating the signing secret of an existing bot."
           },
           "integrations": {
             "type": "object",
@@ -296987,6 +297112,11 @@ var state2 = {
             "maxLength": 2e3,
             "description": "URL of the [Integration](#schema_integration)"
           },
+          "signingSecret": {
+            "type": "string",
+            "maxLength": 2e3,
+            "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+          },
           "name": {
             "type": "string",
             "maxLength": 200,
@@ -297593,6 +297723,7 @@ var state2 = {
           "updatedAt",
           "identifier",
           "url",
+          "signingSecret",
           "name",
           "version",
           "interfaces",
@@ -298697,6 +298828,7 @@ var state2 = {
       "operations": [
         "createBot",
         "updateBot",
+        "rotateBotSigningSecrets",
         "transferBot",
         "listBots",
         "getBot",
@@ -298738,6 +298870,7 @@ var state2 = {
         "createIntegration",
         "validateIntegrationCreation",
         "updateIntegration",
+        "rotateIntegrationSigningSecrets",
         "validateIntegrationUpdate",
         "listIntegrations",
         "getIntegration",
@@ -301380,7 +301513,7 @@ var state3 = {
     "title": "Botpress Files API",
     "description": "API for Botpress Files",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v1"
   },
   "defaultParameters": {
@@ -303676,7 +303809,7 @@ var state4 = {
     "title": "Botpress Tables API",
     "description": "API for Botpress Tables",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v1"
   },
   "defaultParameters": {
@@ -308297,6 +308430,11 @@ var state5 = {
                   "maxLength": 2e3,
                   "description": "URL of the [Integration](#schema_integration)"
                 },
+                "signingSecret": {
+                  "type": "string",
+                  "maxLength": 2e3,
+                  "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+                },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
@@ -308940,6 +309078,7 @@ var state5 = {
                 "updatedAt",
                 "identifier",
                 "url",
+                "signingSecret",
                 "name",
                 "version",
                 "interfaces",
@@ -309065,6 +309204,11 @@ var state5 = {
                   "maxLength": 2e3,
                   "description": "URL of the [Integration](#schema_integration)"
                 },
+                "signingSecret": {
+                  "type": "string",
+                  "maxLength": 2e3,
+                  "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+                },
                 "name": {
                   "type": "string",
                   "maxLength": 200,
@@ -309708,6 +309852,7 @@ var state5 = {
                 "updatedAt",
                 "identifier",
                 "url",
+                "signingSecret",
                 "name",
                 "version",
                 "interfaces",
@@ -312292,9 +312437,10 @@ var state5 = {
             "authentication": {
               "type": "string",
               "enum": [
-                "iam"
+                "iam",
+                "hmac-sha256"
               ],
-              "description": "Type of the [Bot](#schema_bot) authentication (`iam`)"
+              "description": "Type of the [Bot](#schema_bot) authentication (`iam` or `hmac-sha256`)"
             },
             "configuration": {
               "type": "object",
@@ -312771,6 +312917,48 @@ var state5 = {
         "documented"
       ]
     },
+    "rotateBotSigningSecrets": {
+      "name": "rotateBotSigningSecrets",
+      "description": "Rotate bot signing secrets. This will generate a new signing secret and invalidate the old ones after 24 hours.",
+      "method": "post",
+      "section": "bot",
+      "path": "/v1/admin/bots/{id}/signing-secrets/rotate",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Bot ID",
+          "in": "path"
+        }
+      },
+      "requestBody": {
+        "description": "Empty body",
+        "schema": {
+          "type": "object",
+          "title": "rotateBotSigningSecretsBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Success",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "newSigningSecret": {
+              "type": "string",
+              "description": "The new signing secret that can be used immediately. The old signing secret(s) will continue to work for 24 hours after this operation to allow for a smooth transition."
+            }
+          },
+          "required": [
+            "newSigningSecret"
+          ],
+          "title": "rotateBotSigningSecretsResponse",
+          "additionalProperties": false
+        }
+      },
+      "tags": [
+        "experimental"
+      ]
+    },
     "transferBot": {
       "name": "transferBot",
       "description": "Transfer bot to another workspace. You need to be a Manager member of the workspace the bot currently belongs to and have permission to create bots in the target workspace.",
@@ -318478,6 +318666,48 @@ var state5 = {
         "documented"
       ]
     },
+    "rotateIntegrationSigningSecrets": {
+      "name": "rotateIntegrationSigningSecrets",
+      "description": "Rotate integration signing secrets. This will generate a new signing secret and invalidate the old ones after 24 hours.",
+      "method": "post",
+      "section": "integration",
+      "path": "/v1/admin/integrations/{id}/signing-secrets/rotate",
+      "parameters": {
+        "id": {
+          "type": "string",
+          "description": "Integration Version ID",
+          "in": "path"
+        }
+      },
+      "requestBody": {
+        "description": "Empty body",
+        "schema": {
+          "type": "object",
+          "title": "rotateIntegrationSigningSecretsBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Success",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "newSigningSecret": {
+              "type": "string",
+              "description": "The new signing secret that can be used immediately. The old signing secret(s) will continue to work for 24 hours after this operation to allow for a smooth transition."
+            }
+          },
+          "required": [
+            "newSigningSecret"
+          ],
+          "title": "rotateIntegrationSigningSecretsResponse",
+          "additionalProperties": false
+        }
+      },
+      "tags": [
+        "experimental"
+      ]
+    },
     "validateIntegrationUpdate": {
       "name": "validateIntegrationUpdate",
       "description": "Perform a validation of an integration update request",
@@ -325150,7 +325380,7 @@ var state5 = {
     "title": "Botpress API",
     "description": "API for Botpress Cloud",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v1"
   },
   "errors": [
@@ -325321,6 +325551,7 @@ var state5 = {
       "setAccountPreferenceBody": true,
       "createBotBody": true,
       "updateBotBody": true,
+      "rotateBotSigningSecretsBody": true,
       "transferBotBody": true,
       "publishFromBotJsonBody": true,
       "createBotVersionBody": true,
@@ -325339,6 +325570,7 @@ var state5 = {
       "createIntegrationBody": true,
       "validateIntegrationCreationBody": true,
       "updateIntegrationBody": true,
+      "rotateIntegrationSigningSecretsBody": true,
       "validateIntegrationUpdateBody": true,
       "requestIntegrationVerificationBody": true,
       "createInterfaceBody": true,
@@ -325437,6 +325669,7 @@ var state5 = {
       "getPublicInterfaceResponse": true,
       "createBotResponse": true,
       "updateBotResponse": true,
+      "rotateBotSigningSecretsResponse": true,
       "transferBotResponse": true,
       "listBotsResponse": true,
       "getBotResponse": true,
@@ -325494,6 +325727,7 @@ var state5 = {
       "createIntegrationResponse": true,
       "validateIntegrationCreationResponse": true,
       "updateIntegrationResponse": true,
+      "rotateIntegrationSigningSecretsResponse": true,
       "validateIntegrationUpdateResponse": true,
       "listIntegrationsResponse": true,
       "getIntegrationResponse": true,
@@ -325607,7 +325841,7 @@ var state5 = {
           "signingSecret": {
             "type": "string",
             "maxLength": 2e3,
-            "description": "Signing secret of the [Bot](#schema_bot)"
+            "description": "Signing secret of the [Bot](#schema_bot). This field is only visible when creating a new bot or when rotating the signing secret of an existing bot."
           },
           "integrations": {
             "type": "object",
@@ -326387,6 +326621,11 @@ var state5 = {
             "maxLength": 2e3,
             "description": "URL of the [Integration](#schema_integration)"
           },
+          "signingSecret": {
+            "type": "string",
+            "maxLength": 2e3,
+            "description": "Signing secret of the [Integration](#schema_integration). This field is only visible when creating a new integration or when rotating the signing secret of an existing integration."
+          },
           "name": {
             "type": "string",
             "maxLength": 200,
@@ -326993,6 +327232,7 @@ var state5 = {
           "updatedAt",
           "identifier",
           "url",
+          "signingSecret",
           "name",
           "version",
           "interfaces",
@@ -329361,6 +329601,7 @@ var state5 = {
       "operations": [
         "createBot",
         "updateBot",
+        "rotateBotSigningSecrets",
         "transferBot",
         "listBots",
         "getBot",
@@ -329402,6 +329643,7 @@ var state5 = {
         "createIntegration",
         "validateIntegrationCreation",
         "updateIntegration",
+        "rotateIntegrationSigningSecrets",
         "validateIntegrationUpdate",
         "listIntegrations",
         "getIntegration",
@@ -329656,53 +329898,48 @@ var state6 = {
             "description": {
               "type": "string"
             },
-            "providerProductId": {
-              "type": "string"
-            },
             "prices": {
               "type": "object",
-              "additionalProperties": {
-                "type": "object",
-                "properties": {
-                  "providerPriceId": {
-                    "type": "string"
-                  },
-                  "amount": {
-                    "type": "number"
-                  },
-                  "currency": {
-                    "type": "string",
-                    "enum": [
-                      "usd"
-                    ]
-                  },
-                  "interval": {
-                    "type": "string",
-                    "enum": [
-                      "month",
-                      "year"
-                    ]
-                  },
-                  "metadata": {
-                    "type": "object",
-                    "additionalProperties": {
+              "properties": {
+                "month": {
+                  "type": "object",
+                  "properties": {
+                    "amount": {
+                      "type": "number"
+                    },
+                    "currency": {
                       "type": "string"
                     }
-                  }
+                  },
+                  "required": [
+                    "amount",
+                    "currency"
+                  ],
+                  "additionalProperties": false
                 },
-                "required": [
-                  "providerPriceId",
-                  "amount",
-                  "currency",
-                  "interval"
-                ],
-                "additionalProperties": false
-              }
+                "year": {
+                  "type": "object",
+                  "properties": {
+                    "amount": {
+                      "type": "number"
+                    },
+                    "currency": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "amount",
+                    "currency"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
             },
             "features": {
               "type": "object",
               "additionalProperties": {
-                "nullable": true
+                "type": "number"
               }
             },
             "metadata": {
@@ -329716,7 +329953,6 @@ var state6 = {
             "id",
             "name",
             "description",
-            "providerProductId",
             "prices",
             "features"
           ],
@@ -329750,52 +329986,45 @@ var state6 = {
               "description": {
                 "type": "string"
               },
-              "providerProductId": {
-                "type": "string"
-              },
               "prices": {
                 "type": "object",
-                "additionalProperties": {
-                  "type": "object",
-                  "properties": {
-                    "providerPriceId": {
-                      "type": "string"
-                    },
-                    "amount": {
-                      "type": "number"
-                    },
-                    "currency": {
-                      "type": "string",
-                      "enum": [
-                        "usd"
-                      ]
-                    },
-                    "interval": {
-                      "type": "string",
-                      "enum": [
-                        "month",
-                        "year"
-                      ]
-                    },
-                    "metadata": {
-                      "type": "object",
-                      "additionalProperties": {
+                "properties": {
+                  "month": {
+                    "type": "object",
+                    "properties": {
+                      "amount": {
+                        "type": "number"
+                      },
+                      "currency": {
                         "type": "string"
                       }
-                    }
+                    },
+                    "required": [
+                      "amount",
+                      "currency"
+                    ]
                   },
-                  "required": [
-                    "providerPriceId",
-                    "amount",
-                    "currency",
-                    "interval"
-                  ]
+                  "year": {
+                    "type": "object",
+                    "properties": {
+                      "amount": {
+                        "type": "number"
+                      },
+                      "currency": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "amount",
+                      "currency"
+                    ]
+                  }
                 }
               },
               "features": {
                 "type": "object",
                 "additionalProperties": {
-                  "nullable": true
+                  "type": "number"
                 }
               },
               "metadata": {
@@ -329809,10 +330038,10 @@ var state6 = {
               "id",
               "name",
               "description",
-              "providerProductId",
               "prices",
               "features"
-            ]
+            ],
+            "title": "getPlanResponse"
           },
           "title": "listPlansResponse"
         }
@@ -329849,48 +330078,8 @@ var state6 = {
             "description": {
               "type": "string"
             },
-            "providerProductId": {
-              "type": "string"
-            },
-            "prices": {
-              "type": "object",
-              "additionalProperties": {
-                "type": "object",
-                "properties": {
-                  "providerPriceId": {
-                    "type": "string"
-                  },
-                  "amount": {
-                    "type": "number"
-                  },
-                  "currency": {
-                    "type": "string",
-                    "enum": [
-                      "usd"
-                    ]
-                  },
-                  "interval": {
-                    "type": "string",
-                    "enum": [
-                      "month",
-                      "year"
-                    ]
-                  },
-                  "metadata": {
-                    "type": "object",
-                    "additionalProperties": {
-                      "type": "string"
-                    }
-                  }
-                },
-                "required": [
-                  "providerPriceId",
-                  "amount",
-                  "currency",
-                  "interval"
-                ],
-                "additionalProperties": false
-              }
+            "price": {
+              "type": "number"
             },
             "feature": {
               "type": "string",
@@ -329924,8 +330113,7 @@ var state6 = {
             "id",
             "name",
             "description",
-            "providerProductId",
-            "prices",
+            "price",
             "feature",
             "increment"
           ],
@@ -329959,26 +330147,967 @@ var state6 = {
               "description": {
                 "type": "string"
               },
-              "providerProductId": {
-                "type": "string"
+              "price": {
+                "type": "number"
               },
-              "prices": {
+              "feature": {
+                "type": "string",
+                "enum": [
+                  "human_in_the_loop",
+                  "ratelimit",
+                  "incoming_messages_events",
+                  "integration_spend",
+                  "integration_subscription",
+                  "table_rows",
+                  "bot_count",
+                  "always_alive_count",
+                  "always_alive_concurrency",
+                  "collaborator_count",
+                  "file_storage",
+                  "vector_db_storage",
+                  "saved_versions"
+                ]
+              },
+              "increment": {
+                "type": "number"
+              },
+              "metadata": {
                 "type": "object",
                 "additionalProperties": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "description",
+              "price",
+              "feature",
+              "increment"
+            ],
+            "title": "getAddonResponse"
+          },
+          "title": "listAddonsResponse"
+        }
+      },
+      "parameters": {}
+    },
+    "getCurrentSubscription": {
+      "name": "getCurrentSubscription",
+      "description": "Get current subscription for a workspace",
+      "method": "get",
+      "path": "/v2/billing/subscriptions/current",
+      "response": {
+        "description": "Current subscription details",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "properties": {
+            "plan": {
+              "type": "object",
+              "properties": {
+                "current": {
                   "type": "object",
                   "properties": {
-                    "providerPriceId": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "active",
+                        "canceled",
+                        "past_due",
+                        "action_required",
+                        "grace_period"
+                      ]
+                    },
+                    "planId": {
                       "type": "string"
                     },
-                    "amount": {
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
                       "type": "number"
                     },
-                    "currency": {
+                    "proratedPrice": {
+                      "type": "number"
+                    },
+                    "cancelAtPeriodEnd": {
+                      "type": "boolean"
+                    },
+                    "periodEnd": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "status",
+                    "planId",
+                    "interval",
+                    "price",
+                    "cancelAtPeriodEnd",
+                    "periodEnd"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
+                      "type": "number",
+                      "nullable": true
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "planId",
+                    "interval",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            },
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "current": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "proratedPrice": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "effectiveDate": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price",
+                      "effectiveDate"
+                    ],
+                    "nullable": true,
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "current",
+                  "next"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "plan",
+            "addons"
+          ],
+          "title": "getCurrentSubscriptionResponse",
+          "additionalProperties": false
+        }
+      },
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
+    },
+    "getNextSubscription": {
+      "name": "getNextSubscription",
+      "description": "Get next subscription details for a workspace",
+      "method": "get",
+      "path": "/v2/billing/subscriptions/next",
+      "response": {
+        "description": "Next subscription details",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "properties": {
+            "plan": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "active",
+                        "canceled",
+                        "past_due",
+                        "action_required",
+                        "grace_period"
+                      ]
+                    },
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    },
+                    "cancelAtPeriodEnd": {
+                      "type": "boolean"
+                    },
+                    "periodEnd": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "status",
+                    "planId",
+                    "interval",
+                    "price",
+                    "cancelAtPeriodEnd",
+                    "periodEnd"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
                       "type": "string",
                       "enum": [
-                        "usd"
+                        "month",
+                        "year"
                       ]
                     },
+                    "price": {
+                      "type": "number",
+                      "nullable": true
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "planId",
+                    "interval",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            },
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "current": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "proratedPrice": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "effectiveDate": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price",
+                      "effectiveDate"
+                    ],
+                    "nullable": true,
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "current",
+                  "next"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "plan",
+            "addons"
+          ],
+          "title": "getNextSubscriptionResponse",
+          "additionalProperties": false
+        }
+      },
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
+    },
+    "previewSubscriptionUpdate": {
+      "name": "previewSubscriptionUpdate",
+      "description": "Preview subscription update costs (dry run)",
+      "method": "post",
+      "path": "/v2/billing/subscriptions/preview",
+      "requestBody": {
+        "description": "Subscription update parameters to preview",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "plan": {
+              "type": "object",
+              "properties": {
+                "planId": {
+                  "type": "string",
+                  "description": "New plan ID (optional)"
+                },
+                "interval": {
+                  "type": "string",
+                  "enum": [
+                    "month",
+                    "year"
+                  ],
+                  "description": "New billing interval (optional)"
+                }
+              },
+              "required": [
+                "planId",
+                "interval"
+              ],
+              "additionalProperties": false
+            },
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "number"
+              },
+              "description": "Map of addon IDs to quantities (optional). Set quantity to 0 to remove addon."
+            }
+          },
+          "required": [
+            "plan"
+          ],
+          "title": "previewSubscriptionUpdateBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Preview of subscription update costs",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "properties": {
+            "subscription": {
+              "type": "object",
+              "properties": {
+                "plan": {
+                  "type": "object",
+                  "properties": {
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "planId",
+                    "interval",
+                    "effectiveDate"
+                  ],
+                  "additionalProperties": false
+                },
+                "addons": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "effectiveDate": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "effectiveDate"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "plan",
+                "addons"
+              ],
+              "additionalProperties": false
+            },
+            "changeType": {
+              "type": "string",
+              "enum": [
+                "upgrade",
+                "downgrade",
+                "same"
+              ]
+            },
+            "costs": {
+              "type": "object",
+              "properties": {
+                "immediate": {
+                  "type": "object",
+                  "properties": {
+                    "total": {
+                      "type": "number"
+                    },
+                    "lineItems": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "plan",
+                              "addon",
+                              "proration_credit"
+                            ]
+                          },
+                          "id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "amount": {
+                            "type": "number"
+                          },
+                          "quantity": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "id",
+                          "description",
+                          "amount"
+                        ],
+                        "description": "A line item in the cost breakdown"
+                      }
+                    }
+                  },
+                  "required": [
+                    "total",
+                    "lineItems"
+                  ],
+                  "description": "Prorated charges due immediately (0 for downgrades)",
+                  "additionalProperties": false
+                },
+                "monthly": {
+                  "type": "object",
+                  "properties": {
+                    "total": {
+                      "type": "number"
+                    },
+                    "lineItems": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "plan",
+                              "addon",
+                              "proration_credit"
+                            ]
+                          },
+                          "id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "amount": {
+                            "type": "number"
+                          },
+                          "quantity": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "id",
+                          "description",
+                          "amount"
+                        ],
+                        "description": "A line item in the cost breakdown"
+                      }
+                    }
+                  },
+                  "required": [
+                    "total",
+                    "lineItems"
+                  ],
+                  "description": "Monthly recurring cost (addons, or plan if monthly interval)",
+                  "additionalProperties": false
+                },
+                "yearly": {
+                  "type": "object",
+                  "properties": {
+                    "total": {
+                      "type": "number"
+                    },
+                    "lineItems": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "plan",
+                              "addon",
+                              "proration_credit"
+                            ]
+                          },
+                          "id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "amount": {
+                            "type": "number"
+                          },
+                          "quantity": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "id",
+                          "description",
+                          "amount"
+                        ],
+                        "description": "A line item in the cost breakdown"
+                      }
+                    }
+                  },
+                  "required": [
+                    "total",
+                    "lineItems"
+                  ],
+                  "description": "Yearly recurring cost (plan if yearly interval)",
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "immediate",
+                "monthly",
+                "yearly"
+              ],
+              "additionalProperties": false
+            },
+            "currentPeriodEnd": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "subscription",
+            "changeType",
+            "costs",
+            "currentPeriodEnd"
+          ],
+          "description": "Preview of subscription update costs",
+          "title": "previewSubscriptionUpdateResponse",
+          "additionalProperties": false
+        }
+      },
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
+    },
+    "setPlan": {
+      "name": "setPlan",
+      "description": "Update the plan for a workspace subscription",
+      "method": "put",
+      "path": "/v2/billing/plans",
+      "requestBody": {
+        "description": "Plan update parameters",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "planId": {
+              "type": "string"
+            },
+            "interval": {
+              "type": "string",
+              "enum": [
+                "month",
+                "year"
+              ]
+            },
+            "testReferenceTime": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "planId",
+            "interval"
+          ],
+          "description": "Plan update parameters",
+          "title": "setPlanBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Updated subscription details",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "properties": {
+            "plan": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "active",
+                        "canceled",
+                        "past_due",
+                        "action_required",
+                        "grace_period"
+                      ]
+                    },
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    },
+                    "cancelAtPeriodEnd": {
+                      "type": "boolean"
+                    },
+                    "periodEnd": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "status",
+                    "planId",
+                    "interval",
+                    "price",
+                    "cancelAtPeriodEnd",
+                    "periodEnd"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
+                      "type": "number",
+                      "nullable": true
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "planId",
+                    "interval",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            },
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "current": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "proratedPrice": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "effectiveDate": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price",
+                      "effectiveDate"
+                    ],
+                    "nullable": true,
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "current",
+                  "next"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "plan",
+            "addons"
+          ],
+          "description": "Subscription details including current plan, addons, and costs",
+          "title": "setPlanResponse",
+          "additionalProperties": false
+        }
+      },
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
+    },
+    "setAddons": {
+      "name": "setAddons",
+      "description": "Update addons for a workspace subscription",
+      "method": "patch",
+      "path": "/v2/billing/addons",
+      "requestBody": {
+        "description": "Addons update parameters. Set quantity to 0 to remove an addon.",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "number"
+              }
+            }
+          },
+          "required": [
+            "addons"
+          ],
+          "description": "Addons update parameters. Set quantity to 0 to remove an addon.",
+          "title": "setAddonsBody",
+          "additionalProperties": false
+        }
+      },
+      "response": {
+        "description": "Updated subscription details",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "properties": {
+            "plan": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "active",
+                        "canceled",
+                        "past_due",
+                        "action_required",
+                        "grace_period"
+                      ]
+                    },
+                    "planId": {
+                      "type": "string"
+                    },
+                    "interval": {
+                      "type": "string",
+                      "enum": [
+                        "month",
+                        "year"
+                      ]
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    },
+                    "cancelAtPeriodEnd": {
+                      "type": "boolean"
+                    },
+                    "periodEnd": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "status",
+                    "planId",
+                    "interval",
+                    "price",
+                    "cancelAtPeriodEnd",
+                    "periodEnd"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "planId": {
+                      "type": "string"
+                    },
                     "interval": {
                       "type": "string",
                       "enum": [
@@ -329986,63 +331115,101 @@ var state6 = {
                         "year"
                       ]
                     },
-                    "metadata": {
-                      "type": "object",
-                      "additionalProperties": {
-                        "type": "string"
-                      }
+                    "price": {
+                      "type": "number",
+                      "nullable": true
+                    },
+                    "effectiveDate": {
+                      "type": "string"
                     }
                   },
                   "required": [
-                    "providerPriceId",
-                    "amount",
-                    "currency",
-                    "interval"
-                  ]
+                    "planId",
+                    "interval",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
                 }
               },
-              "feature": {
-                "type": "string",
-                "enum": [
-                  "human_in_the_loop",
-                  "ratelimit",
-                  "incoming_messages_events",
-                  "integration_spend",
-                  "integration_subscription",
-                  "table_rows",
-                  "bot_count",
-                  "always_alive_count",
-                  "always_alive_concurrency",
-                  "collaborator_count",
-                  "file_storage",
-                  "vector_db_storage",
-                  "saved_versions"
-                ]
-              },
-              "increment": {
-                "type": "number"
-              },
-              "metadata": {
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            },
+            "addons": {
+              "type": "object",
+              "additionalProperties": {
                 "type": "object",
-                "additionalProperties": {
-                  "type": "string"
-                }
+                "properties": {
+                  "current": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "proratedPrice": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "quantity": {
+                        "type": "number"
+                      },
+                      "price": {
+                        "type": "number"
+                      },
+                      "effectiveDate": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "quantity",
+                      "price",
+                      "effectiveDate"
+                    ],
+                    "nullable": true,
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "current",
+                  "next"
+                ],
+                "additionalProperties": false
               }
-            },
-            "required": [
-              "id",
-              "name",
-              "description",
-              "providerProductId",
-              "prices",
-              "feature",
-              "increment"
-            ]
+            }
           },
-          "title": "listAddonsResponse"
+          "required": [
+            "plan",
+            "addons"
+          ],
+          "description": "Subscription details including current plan, addons, and costs",
+          "title": "setAddonsResponse",
+          "additionalProperties": false
         }
       },
-      "parameters": {}
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
     },
     "listInvoices": {
       "name": "listInvoices",
@@ -330140,7 +331307,6 @@ var state6 = {
             "invoices",
             "meta"
           ],
-          "description": "List of invoices with pagination.",
           "title": "listInvoicesResponse",
           "additionalProperties": false
         }
@@ -330425,13 +331591,38 @@ var state6 = {
           "required": true
         }
       }
+    },
+    "getQuotas": {
+      "name": "getQuotas",
+      "description": "Get calculated quotas for the authenticated workspace based on plan and addons",
+      "method": "get",
+      "path": "/v2/billing/quotas",
+      "response": {
+        "description": "Calculated quotas for the workspace (featureId -> value)",
+        "status": 200,
+        "schema": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "number"
+          },
+          "title": "getQuotasResponse"
+        }
+      },
+      "parameters": {
+        "x-workspace-id": {
+          "in": "header",
+          "type": "string",
+          "description": "Workspace ID",
+          "required": true
+        }
+      }
     }
   },
   "metadata": {
     "title": "Botpress Billing Public API",
     "description": "API for Botpress Billing",
     "server": "https://api.botpress.cloud",
-    "version": "1.71.0",
+    "version": "1.72.0",
     "prefix": "v2"
   },
   "defaultParameters": {
@@ -330577,6 +331768,9 @@ var state6 = {
   "refs": {
     "parameters": {},
     "requestBodies": {
+      "previewSubscriptionUpdateBody": true,
+      "setPlanBody": true,
+      "setAddonsBody": true,
       "payInvoiceBody": true,
       "setPaymentMethodBody": true,
       "createPaymentMethodIntentBody": true
@@ -330587,14 +331781,26 @@ var state6 = {
       "listPlansResponse": true,
       "getAddonResponse": true,
       "listAddonsResponse": true,
+      "getCurrentSubscriptionResponse": true,
+      "getNextSubscriptionResponse": true,
+      "previewSubscriptionUpdateResponse": true,
+      "setPlanResponse": true,
+      "setAddonsResponse": true,
       "listInvoicesResponse": true,
       "payInvoiceResponse": true,
       "getPaymentMethodResponse": true,
       "setPaymentMethodResponse": true,
-      "createPaymentMethodIntentResponse": true
+      "createPaymentMethodIntentResponse": true,
+      "getQuotasResponse": true
     },
     "schemas": {
-      "Invoice": true
+      "Invoice": true,
+      "Subscription": true,
+      "SubscriptionPreview": true,
+      "SubscriptionUpdateParams": true,
+      "SubscriptionDetails": true,
+      "SetPlanParams": true,
+      "SetAddonsParams": true
     }
   },
   "schemas": {
@@ -330653,7 +331859,550 @@ var state6 = {
           "dueDate",
           "pdfUrl"
         ],
-        "description": "The invoice object.",
+        "additionalProperties": false
+      }
+    },
+    "Subscription": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "plan": {
+            "type": "object",
+            "properties": {
+              "current": {
+                "type": "object",
+                "properties": {
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "active",
+                      "canceled",
+                      "past_due",
+                      "action_required",
+                      "grace_period"
+                    ]
+                  },
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number"
+                  },
+                  "proratedPrice": {
+                    "type": "number"
+                  },
+                  "cancelAtPeriodEnd": {
+                    "type": "boolean"
+                  },
+                  "periodEnd": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "status",
+                  "planId",
+                  "interval",
+                  "price",
+                  "cancelAtPeriodEnd",
+                  "periodEnd"
+                ],
+                "additionalProperties": false
+              },
+              "next": {
+                "type": "object",
+                "properties": {
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number",
+                    "nullable": true
+                  },
+                  "effectiveDate": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "planId",
+                  "interval",
+                  "price",
+                  "effectiveDate"
+                ],
+                "nullable": true,
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "current",
+              "next"
+            ],
+            "additionalProperties": false
+          },
+          "addons": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "plan",
+          "addons"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "SubscriptionPreview": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "plan": {
+            "type": "object",
+            "properties": {
+              "current": {
+                "type": "object",
+                "properties": {
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "active",
+                      "canceled",
+                      "past_due",
+                      "action_required",
+                      "grace_period"
+                    ]
+                  },
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number"
+                  },
+                  "proratedPrice": {
+                    "type": "number"
+                  },
+                  "cancelAtPeriodEnd": {
+                    "type": "boolean"
+                  },
+                  "periodEnd": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "status",
+                  "planId",
+                  "interval",
+                  "price",
+                  "cancelAtPeriodEnd",
+                  "periodEnd"
+                ],
+                "additionalProperties": false
+              },
+              "next": {
+                "type": "object",
+                "properties": {
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number",
+                    "nullable": true
+                  },
+                  "effectiveDate": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "planId",
+                  "interval",
+                  "price",
+                  "effectiveDate"
+                ],
+                "nullable": true,
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "current",
+              "next"
+            ],
+            "additionalProperties": false
+          },
+          "addons": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "plan",
+          "addons"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "SubscriptionUpdateParams": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "plan": {
+            "type": "object",
+            "properties": {
+              "planId": {
+                "type": "string",
+                "description": "New plan ID (optional)"
+              },
+              "interval": {
+                "type": "string",
+                "enum": [
+                  "month",
+                  "year"
+                ],
+                "description": "New billing interval (optional)"
+              }
+            },
+            "required": [
+              "planId",
+              "interval"
+            ],
+            "additionalProperties": false
+          },
+          "addons": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number"
+            },
+            "description": "Map of addon IDs to quantities (optional). Set quantity to 0 to remove addon."
+          }
+        },
+        "required": [
+          "plan"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "SubscriptionDetails": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "plan": {
+            "type": "object",
+            "properties": {
+              "current": {
+                "type": "object",
+                "properties": {
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "active",
+                      "canceled",
+                      "past_due",
+                      "action_required",
+                      "grace_period"
+                    ]
+                  },
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number"
+                  },
+                  "proratedPrice": {
+                    "type": "number"
+                  },
+                  "cancelAtPeriodEnd": {
+                    "type": "boolean"
+                  },
+                  "periodEnd": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "status",
+                  "planId",
+                  "interval",
+                  "price",
+                  "cancelAtPeriodEnd",
+                  "periodEnd"
+                ],
+                "additionalProperties": false
+              },
+              "next": {
+                "type": "object",
+                "properties": {
+                  "planId": {
+                    "type": "string"
+                  },
+                  "interval": {
+                    "type": "string",
+                    "enum": [
+                      "month",
+                      "year"
+                    ]
+                  },
+                  "price": {
+                    "type": "number",
+                    "nullable": true
+                  },
+                  "effectiveDate": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "planId",
+                  "interval",
+                  "price",
+                  "effectiveDate"
+                ],
+                "nullable": true,
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "current",
+              "next"
+            ],
+            "additionalProperties": false
+          },
+          "addons": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "current": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "proratedPrice": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price"
+                  ],
+                  "additionalProperties": false
+                },
+                "next": {
+                  "type": "object",
+                  "properties": {
+                    "quantity": {
+                      "type": "number"
+                    },
+                    "price": {
+                      "type": "number"
+                    },
+                    "effectiveDate": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "quantity",
+                    "price",
+                    "effectiveDate"
+                  ],
+                  "nullable": true,
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "current",
+                "next"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "plan",
+          "addons"
+        ],
+        "description": "Subscription details including current plan, addons, and costs",
+        "additionalProperties": false
+      }
+    },
+    "SetPlanParams": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "string"
+          },
+          "interval": {
+            "type": "string",
+            "enum": [
+              "month",
+              "year"
+            ]
+          },
+          "testReferenceTime": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "planId",
+          "interval"
+        ],
+        "description": "Plan update parameters",
+        "additionalProperties": false
+      }
+    },
+    "SetAddonsParams": {
+      "section": "subscription",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "addons": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "number"
+            }
+          }
+        },
+        "required": [
+          "addons"
+        ],
+        "description": "Addons update parameters. Set quantity to 0 to remove an addon.",
         "additionalProperties": false
       }
     }
@@ -330665,6 +332414,13 @@ var state6 = {
       "name": "invoice",
       "operations": [],
       "schema": "Invoice"
+    },
+    {
+      "description": "",
+      "title": "Subscription",
+      "name": "subscription",
+      "operations": [],
+      "schema": "Subscription"
     }
   ],
   "options": {