Add authorization event and webhook types

[csrbarber]

Description

Add event and webhook types for organization_role (created, updated, deleted) and permission (created, updated, deleted) to support authorization-related event streaming and webhook delivery.

Documentation

Does this require changes to the WorkOS Docs? E.g. the API Reference or code snippets need updates.

[X] Yes

If yes, link a related docs PR and add a docs maintainer as a reviewer. Their approval is required.

[linear]

ENT-4799 workos-python

[greptile-apps]

Greptile Overview

Greptile Summary

Added complete event and webhook type support for authorization-related resources (organization_role and permission). The changes include:

• Created six new event classes: OrganizationRoleCreatedEvent, OrganizationRoleUpdatedEvent, OrganizationRoleDeletedEvent, PermissionCreatedEvent, PermissionUpdatedEvent, PermissionDeletedEvent
• Created corresponding webhook classes with identical naming pattern
• Registered all new types in discriminated unions for proper type discrimination
• Added OrganizationRole and Permission to EventPayload TypeVar
• Added corresponding event type literals to EventType

The implementation follows existing patterns consistently, using EventModel[OrganizationRole] and EventModel[Permission] generics, Literal discriminators, and proper alphabetical ordering in unions. All imports reference existing authorization types from workos/types/authorization/.

Confidence Score: 5/5

• This PR is safe to merge with no risk
• Changes are purely additive type definitions following established patterns exactly - no logic, no security concerns, no breaking changes, just new event/webhook types for authorization features
• No files require special attention

Important Files Changed

Filename	Overview
workos/types/events/event_type.py	Added six new event type literals for organization_role and permission events (created, updated, deleted)
workos/types/events/event_model.py	Added OrganizationRole and Permission imports and to EventPayload TypeVar for type safety
workos/types/events/event.py	Added six event classes and registered them in Event union for authorization role and permission events
workos/types/webhooks/webhook.py	Added six webhook classes and registered them in Webhook union for authorization role and permission webhooks

Sequence Diagram

sequenceDiagram
    participant Client as SDK Client
    participant API as WorkOS API
    participant Webhook as Webhook Handler
    
    Note over Client,API: Authorization Resource Operations
    Client->>API: Create/Update/Delete OrganizationRole
    API-->>Client: OrganizationRole response
    API->>Webhook: organization_role.created/updated/deleted event
    Webhook->>Webhook: Parse OrganizationRoleWebhook type
    
    Client->>API: Create/Update/Delete Permission
    API-->>Client: Permission response
    API->>Webhook: permission.created/updated/deleted event
    Webhook->>Webhook: Parse PermissionWebhook type
    
    Note over Webhook: Both event types use discriminated unions<br/>for type-safe deserialization

Loading

_{Last reviewed commit: 94a09eb}

[greptile-apps]

_{4 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}