chore(python): regenerate SDK with exceptions and types backwards-compat

Restores `from workos.exceptions import ...` and `from workos.types.<service> import ...`
import paths. Updates V6 migration guide to remove these as breaking changes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gjtorikian

docs/V6_MIGRATION_GUIDE.md

@@ -15,8 +15,6 @@ Read this as the migration guide for the generated-surface major release, not as
     - [Python 3.10+ is now required](#python-310-is-now-required)
     - [`client_id` is only required for flows that use it](#client_id-is-only-required-for-flows-that-use-it)
     - [Legacy client modules were removed](#legacy-client-modules-were-removed)
-    - [SDK exceptions now come from `workos`, not `workos.exceptions`](#sdk-exceptions-now-come-from-workos-not-workosexceptions)
-    - [Models no longer live under `workos.types.*`](#models-no-longer-live-under-workostypes)
     - [SDK models are no longer Pydantic models](#sdk-models-are-no-longer-pydantic-models)
     - [`client.connect` was split into explicit resources](#clientconnect-was-split-into-explicit-resources)
     - [`client.directory_sync` was split into directories, groups, and users](#clientdirectory_sync-was-split-into-directories-groups-and-users)
@@ -36,7 +34,7 @@ Read this as the migration guide for the generated-surface major release, not as
 
 1. Upgrade to Python 3.10 or newer.
 2. Update to the v6 release.
-3. Replace legacy imports from `workos.client`, `workos.async_client`, `workos.exceptions`, and `workos.types.*`.
+3. Replace legacy imports from `workos.client` and `workos.async_client`.
 4. Update any uses of `connect`, `portal`, `directory_sync`, `fga`, `authorization` permission helpers, and old `user_management` convenience helpers.
 5. Run your tests and look specifically for import errors, missing methods, and model serialization issues.
 
@@ -105,52 +103,6 @@ client = WorkOSClient(api_key="sk_test_123", client_id="client_123")
 **Affected users:** Anyone importing `SyncClient`, `AsyncClient`, or other client classes from legacy client modules
 **Migration:** Import clients from the top-level `workos` package instead of `workos.client` or `workos.async_client`
 
-### SDK exceptions now come from `workos`, not `workos.exceptions`
-
-**5.x (old):**
-
-```python
-from workos.exceptions import BaseRequestException
-
-try:
-    client.organizations.get_organization("org_123")
-except BaseRequestException as exc:
-    print(exc.request_id)
-```
-
-**6.x (new):**
-
-```python
-from workos import BaseRequestException
-
-try:
-    client.organizations.get("org_123")
-except BaseRequestException as exc:
-    print(exc.request_id)
-```
-
-**Affected users:** Anyone importing exception classes from `workos.exceptions`
-**Migration:** Import exception classes directly from `workos`
-
-### Models no longer live under `workos.types.*`
-
-**5.x (old):**
-
-```python
-from workos.types.organizations import Organization
-from workos.types.connect import ConnectApplication
-```
-
-**6.x (new):**
-
-```python
-from workos.organizations.models import Organization
-from workos.applications.models import ConnectApplication
-```
-
-**Affected users:** Anyone importing SDK models from `workos.types.*`
-**Migration:** Import models from the generated `workos.<resource>.models` packages
-
 ### SDK models are no longer Pydantic models
 
 **5.x (old):**
@@ -456,7 +408,7 @@ organization = client.organizations.get("org_123")
 
 1. Upgrade Python to 3.10+.
 2. Review which flows need `client_id` and either pass it explicitly or configure it on the client / environment.
-3. Fix imports from `workos.client`, `workos.async_client`, `workos.exceptions`, and `workos.types.*`.
+3. Fix imports from `workos.client` and `workos.async_client`.
 4. Replace old namespaces: `connect`, `directory_sync`, `portal`, `fga`, and handwritten `user_management` helpers.
 5. Move permission CRUD from `client.authorization` to `client.permissions`.
 6. Update model serialization code away from Pydantic helpers.
@@ -466,8 +418,6 @@ organization = client.organizations.get("org_123")
 
 - No imports from `workos.client`
 - No imports from `workos.async_client`
-- No imports from `workos.exceptions`
-- No imports from `workos.types.*`
 - Client-ID-based flows explicitly pass `client_id` or configure it on the client / environment
 - No remaining uses of `client.connect`
 - No remaining uses of `client.directory_sync`

src/workos/audit_logs/models/audit_log_action_json.py

@@ -20,6 +20,7 @@ class AuditLogActionJson:
     name: str
     """Identifier of what action was taken."""
     schema: "AuditLogSchemaJson"
+    """The schema associated with the action."""
     created_at: datetime
     """An ISO 8601 timestamp."""
     updated_at: datetime

src/workos/audit_logs/models/audit_log_schema_json.py

@@ -14,7 +14,7 @@
 
 @dataclass(slots=True)
 class AuditLogSchemaJson:
-    """The schema associated with the action."""
+    """Audit Log Schema Json model."""
 
     object: Literal["audit_log_schema"]
     """Distinguishes the Audit Log Schema object."""

src/workos/authorization/models/role_assignment.py

@@ -21,6 +21,7 @@ class RoleAssignment:
     id: str
     """Unique identifier of the role assignment."""
     role: "SlimRole"
+    """The role included in the assignment."""
     resource: "RoleAssignmentResource"
     """The resource to which the role is assigned."""
     created_at: datetime

src/workos/authorization/models/slim_role.py

@@ -9,7 +9,7 @@
 
 @dataclass(slots=True)
 class SlimRole:
-    """The role included in the assignment."""
+    """The primary role assigned to the user."""
 
     slug: str
     """The slug of the assigned role."""

src/workos/directory_users/models/directory_user_with_groups.py

@@ -53,7 +53,6 @@ class DirectoryUserWithGroups:
     username: Optional[str] = None
     """The username of the user."""
     role: Optional["SlimRole"] = None
-    """The primary role assigned to the user."""
     roles: Optional[List["SlimRole"]] = None
     """All roles assigned to the user."""
 

src/workos/events/_resource.py

@@ -8,7 +8,7 @@
     from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
-from .models import Event
+from .models import EventSchema
 from .models import EventsOrder
 from .._pagination import AsyncPage, SyncPage
 
@@ -31,7 +31,7 @@ def list(
         range_end: Optional[str] = None,
         organization_id: Optional[str] = None,
         request_options: Optional[RequestOptions] = None,
-    ) -> SyncPage[Event]:
+    ) -> SyncPage[EventSchema]:
         """List events
 
         List events for the current environment.
@@ -48,7 +48,7 @@ def list(
                     request_options: Per-request options. Supports extra_headers, timeout, max_retries, and base_url override.
 
                 Returns:
-                    SyncPage[Event]
+                    SyncPage[EventSchema]
 
                 Raises:
                     BadRequestException: If the request is malformed (400).
@@ -74,7 +74,7 @@ def list(
         return self._client.request_page(
             method="get",
             path="events",
-            model=Event,
+            model=EventSchema,
             params=params,
             request_options=request_options,
         )
@@ -98,7 +98,7 @@ async def list(
         range_end: Optional[str] = None,
         organization_id: Optional[str] = None,
         request_options: Optional[RequestOptions] = None,
-    ) -> AsyncPage[Event]:
+    ) -> AsyncPage[EventSchema]:
         """List events
 
         List events for the current environment.
@@ -115,7 +115,7 @@ async def list(
                     request_options: Per-request options. Supports extra_headers, timeout, max_retries, and base_url override.
 
                 Returns:
-                    AsyncPage[Event]
+                    AsyncPage[EventSchema]
 
                 Raises:
                     BadRequestException: If the request is malformed (400).
@@ -141,7 +141,7 @@ async def list(
         return await self._client.request_page(
             method="get",
             path="events",
-            model=Event,
+            model=EventSchema,
             params=params,
             request_options=request_options,
         )

src/workos/events/models/__init__.py

@@ -1,4 +1,4 @@
 # This file is auto-generated by oagen. Do not edit.
 
-from .event import Event as Event
+from .event_schema import EventSchema as EventSchema
 from .events_order import EventsOrder as EventsOrder

src/workos/events/models/event_schema.py

@@ -0,0 +1,59 @@
+# This file is auto-generated by oagen. Do not edit.
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any, Dict, Literal, Optional
+from workos._errors import BaseRequestException
+
+
+@dataclass(slots=True)
+class EventSchema:
+    """An event emitted by WorkOS."""
+
+    object: Literal["event"]
+    """Distinguishes the Event object."""
+    id: str
+    """Unique identifier for the Event."""
+    event: str
+    """The type of event that occurred."""
+    data: Dict[str, Any]
+    """The event payload."""
+    created_at: datetime
+    """An ISO 8601 timestamp."""
+    context: Optional[Dict[str, Any]] = None
+    """Additional context about the event."""
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "EventSchema":
+        """Deserialize from a dictionary."""
+        try:
+            return cls(
+                object=data["object"],
+                id=data["id"],
+                event=data["event"],
+                data=data["data"],
+                created_at=datetime.fromisoformat(
+                    data["created_at"].replace("Z", "+00:00")
+                ),
+                context=data.get("context"),
+            )
+        except (KeyError, ValueError) as e:
+            raise BaseRequestException(
+                f"Unexpected API response while parsing EventSchema: {e!s}"
+            ) from e
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Serialize to a dictionary."""
+        result: Dict[str, Any] = {}
+        result["object"] = self.object
+        result["id"] = self.id
+        result["event"] = self.event
+        result["data"] = self.data
+        result["created_at"] = self.created_at.isoformat(
+            timespec="milliseconds"
+        ).replace("+00:00", "Z")
+        if self.context is not None:
+            result["context"] = self.context
+        return result

src/workos/exceptions.py

@@ -0,0 +1,41 @@
+# This file is auto-generated by oagen. Do not edit.
+
+"""Backwards-compatible re-export of exception classes.
+
+Allows 'from workos.exceptions import ...' alongside the
+canonical 'from workos import ...' path.
+"""
+
+from ._errors import (
+    BaseRequestException as BaseRequestException,
+    AuthenticationException as AuthenticationException,
+    AuthorizationException as AuthorizationException,
+    BadRequestException as BadRequestException,
+    ConflictException as ConflictException,
+    ConfigurationException as ConfigurationException,
+    EmailVerificationRequiredException as EmailVerificationRequiredException,
+    NotFoundException as NotFoundException,
+    RateLimitExceededException as RateLimitExceededException,
+    ServerException as ServerException,
+    UnprocessableEntityException as UnprocessableEntityException,
+    WorkOSConnectionException as WorkOSConnectionException,
+    WorkOSTimeoutException as WorkOSTimeoutException,
+    STATUS_CODE_TO_EXCEPTION as STATUS_CODE_TO_EXCEPTION,
+)
+
+__all__ = [
+    "BaseRequestException",
+    "AuthenticationException",
+    "AuthorizationException",
+    "BadRequestException",
+    "ConflictException",
+    "ConfigurationException",
+    "EmailVerificationRequiredException",
+    "NotFoundException",
+    "RateLimitExceededException",
+    "ServerException",
+    "UnprocessableEntityException",
+    "WorkOSConnectionException",
+    "WorkOSTimeoutException",
+    "STATUS_CODE_TO_EXCEPTION",
+]