Add custom_attributes field to OrganizationMembership

[ajworkos]

Summary

Adds custom_attributes field to OrganizationMembership model to expose custom attributes from identity providers.

Changes

• Added custom_attributes field to OrganizationMembership type/model
• Field type: Record/Map/Dictionary of string keys to any values
• Always present, defaults to empty object {}
• Updated fixtures and tests

API Field Details

The field will be present in:

• REST API responses
• Webhook events
• Events API responses

JSON field name: custom_attributes (snake_case)

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds the idp_attributes field to OrganizationMembership to expose IDP custom attributes from the WorkOS API (which provides them as customAttributes).

Key Changes:

• Added idp_attributes: dict[str, Any] field to OrganizationMembership model
• Updated MockOrganizationMembership fixture with idp_attributes={}

Issues Found:

• Python 3.8 compatibility broken: The PR uses lowercase dict[str, Any] syntax which is only available in Python 3.9+, but the project supports Python >=3.8. The codebase consistently uses Dict[str, Any] from the typing module for compatibility.
• Missing import: The Dict type needs to be imported from typing module.
• Verify field optionality: Confirm whether the API always returns this field. If it can be missing for older records or when IDP attributes aren't configured, it should be Optional[Dict[str, Any]] = None to prevent deserialization errors.

Confidence Score: 2/5

• This PR will break Python 3.8 compatibility and should not be merged without fixes
• Score reflects critical Python 3.8 compatibility issue with lowercase dict syntax. The codebase requires Python >=3.8 support but uses Python 3.9+ syntax. This will cause runtime errors on Python 3.8 installations.
• Pay close attention to src/workos/types/user_management/organization_membership.py which requires type annotation fixes

Important Files Changed

Filename	Overview
src/workos/types/user_management/organization_membership.py	Added idp_attributes field but used Python 3.9+ syntax incompatible with Python 3.8; needs Dict import and capitalization
tests/utils/fixtures/mock_organization_membership.py	Correctly added idp_attributes={} to mock fixture; clean implementation

Sequence Diagram

sequenceDiagram
    participant IDP as Identity Provider
    participant API as WorkOS API
    participant SDK as Python SDK
    participant App as Application Code
    
    IDP->>API: Provides user attributes<br/>(department, employee_id, etc.)
    Note over API: Stores as customAttributes<br/>in organizationMembership
    
    App->>SDK: list_organization_memberships()
    SDK->>API: GET /organization_memberships
    API->>SDK: Returns JSON with customAttributes
    Note over SDK: Deserializes to<br/>OrganizationMembership.idp_attributes
    SDK->>App: OrganizationMembership object
    
    Note over App: Access IDP attributes:<br/>membership.idp_attributes["department"]

Loading

[greptile-apps]

_{2 files reviewed, 3 comments}

_{Edit Code Review Agent Settings | Greptile}

[mattgd]

We've been preferring to use Mapping instead of Dict for these read-only cases:

Suggested change

	custom_attributes: Dict[str, Any]
	custom_attributes: Mapping[str, Any]