@workos/openapi-spec 0.28.0 → 0.29.0

package/dist/open-api-spec.yaml

@@ -18851,8 +18851,10 @@ paths:
   /widgets/token:
     post:
       description: >-
-        Generate a widget token scoped to an organization and user with the
-        specified scopes.
+        Generate a widget token for a user, optionally scoped to an
+        organization. When an organization is specified, org-scoped widgets are
+        enabled; omitting it issues a user-only token for widgets like
+        `UserProfile` and `UserSecurity`.
       operationId: WidgetsPublicController_issueWidgetSessionToken
       parameters: []
       requestBody:
@@ -21714,7 +21716,11 @@ components:
       properties:
         organization_id:
           type: string
-          description: The ID of the organization to scope the widget session to.
+          description: >-
+            The ID of the organization to scope the widget session to. Required
+            when scopes are provided. Optional when issuing a token for
+            user-only widgets (e.g. `UserProfile`, `UserSecurity`) that do not
+            require organization context.
           example: org_01EHZNVPK3SFK441A1RGBFSHRT
         user_id:
           type: string
@@ -21735,8 +21741,6 @@ components:
               - widgets:pipes:manage
           example:
             - widgets:users-table:manage
-      required:
-        - organization_id
     ClientApiTokenDto:
       type: object
       properties:

package/dist/types.d.ts

@@ -3162,7 +3162,7 @@ export interface paths {
         put?: never;
         /**
          * Generate a widget token
-         * @description Generate a widget token scoped to an organization and user with the specified scopes.
+         * @description Generate a widget token for a user, optionally scoped to an organization. When an organization is specified, org-scoped widgets are enabled; omitting it issues a user-only token for widgets like `UserProfile` and `UserSecurity`.
          */
         post: operations["WidgetsPublicController_issueWidgetSessionToken"];
         delete?: never;
@@ -4832,10 +4832,10 @@ export interface components {
         };
         WidgetSessionTokenDto: {
             /**
-             * @description The ID of the organization to scope the widget session to.
+             * @description The ID of the organization to scope the widget session to. Required when scopes are provided. Optional when issuing a token for user-only widgets (e.g. `UserProfile`, `UserSecurity`) that do not require organization context.
              * @example org_01EHZNVPK3SFK441A1RGBFSHRT
              */
-            organization_id: string;
+            organization_id?: string;
             /**
              * @description The ID of the user to issue the widget session token for.
              * @example user_01E4ZCR3C56J083X43JQXF3JK5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workos/openapi-spec",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "type": "module",
   "description": "WorkOS OpenAPI specification, TypeScript types, and SDK resolution policy",
   "license": "MIT",