workos/workos-php
WorkOS PHP Library
v9.2.0
3.3M downloads/mo
#2096 most downloaded on Packagist
workos/workos-php
What this package is like to depend on
Last release 12 days ago
11 Aug 2026
Ships fairly regularly
a new release about every 3 weeks
Rarely documented
notes for 21 of 100 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
100 releases · first in 2020
26 releases in the last 12 months
see the full history below
Release timeline
100 releases · Apr 2020 to Aug 2026Releases
latest 60 of 100-
v9.2.011 Aug 2026Release notes
Open source →-
#428 feat(generated)!: regenerate from spec (2 changes)
⚠️ Breaking
- events:
- Changed required status for parameter
Events.list.events
- Changed required status for parameter
Features
- groups:
- Added parameter
Groups.list.search
- Added parameter
- connect:
- Added
client_idtoConnectedAccount - Added
client_secret_last_4toConnectedAccount - Added
configtoConnectedAccount
- Added
- pipes:
- Added
client_idtoDataIntegrationsListResponseDataConnectedAccount - Added
client_secret_last_4toDataIntegrationsListResponseDataConnectedAccount - Added
configtoDataIntegrationsListResponseDataConnectedAccount - Changed errors for endpoint
POST /data-integrations/{slug}/credentials - Made
CustomProviderDefinition.authorization_urloptional - Made
CustomProviderDefinition.token_urloptional - Added model
DataIntegrationsUpsertClientCredentialsRequest - Added
client_credentialstoCreateDataIntegrationAuthMethods - Added endpoint
PUT /data-integrations/{slug}/client-credentials
- Added
- sso:
- Added
XOAuthtoConnectionType - Added
XOAuthtoProfileConnectionType - Added
XOAuthtoConnectionsConnectionType - Added
GrokOAuthtoConnectionType - Added
GrokOAuthtoProfileConnectionType - Added
GrokOAuthtoConnectionsConnectionType
- Added
- user_management:
- Changed errors for endpoint
DELETE /user_management/users/{id} - Added
password_salt_positiontoCreateUser - Added
password_salt_positiontoUpdateUser - Made
RadarSmsChallengeCodeSessionAuthenticateRequest.verification_idoptional - Made
RadarSmsChallengeCodeSessionAuthenticateRequest.phone_numberoptional - Added enum
CreateUserPasswordSaltPosition - Added enum
UpdateUserPasswordSaltPosition - Added
XOAuthtoAuthenticateResponseAuthenticationMethod - Added
XOAuthtoUserIdentitiesGetItemProvider - Added
GrokOAuthtoAuthenticateResponseAuthenticationMethod - Added
GrokOAuthtoUserIdentitiesGetItemProvider
- Changed errors for endpoint
- webhooks:
- Added
agent.registration.refreshedtoCreateWebhookEndpointEvents - Added
agent.registration.refreshedtoUpdateWebhookEndpointEvents
- Added
Fixes
- pipes:
- Changed the type of
DataIntegration.credentials
- Changed the type of
- user_management:
- Changed errors for endpoint
POST /user_management/authenticate - Changed errors for endpoint
POST /user_management/users - Changed errors for endpoint
PUT /user_management/users/{id}
- Changed errors for endpoint
- events:
Release notes
Open source →-
#428 feat(generated)!: regenerate from spec (2 changes)
⚠️ Breaking
- events:
- Changed required status for parameter
Events.list.events
- Changed required status for parameter
Features
- groups:
- Added parameter
Groups.list.search
- Added parameter
- connect:
- Added
client_idtoConnectedAccount - Added
client_secret_last_4toConnectedAccount - Added
configtoConnectedAccount
- Added
- pipes:
- Added
client_idtoDataIntegrationsListResponseDataConnectedAccount - Added
client_secret_last_4toDataIntegrationsListResponseDataConnectedAccount - Added
configtoDataIntegrationsListResponseDataConnectedAccount - Changed errors for endpoint
POST /data-integrations/{slug}/credentials - Made
CustomProviderDefinition.authorization_urloptional - Made
CustomProviderDefinition.token_urloptional - Added model
DataIntegrationsUpsertClientCredentialsRequest - Added
client_credentialstoCreateDataIntegrationAuthMethods - Added endpoint
PUT /data-integrations/{slug}/client-credentials
- Added
- sso:
- Added
XOAuthtoConnectionType - Added
XOAuthtoProfileConnectionType - Added
XOAuthtoConnectionsConnectionType - Added
GrokOAuthtoConnectionType - Added
GrokOAuthtoProfileConnectionType - Added
GrokOAuthtoConnectionsConnectionType
- Added
- user_management:
- Changed errors for endpoint
DELETE /user_management/users/{id} - Added
password_salt_positiontoCreateUser - Added
password_salt_positiontoUpdateUser - Made
RadarSmsChallengeCodeSessionAuthenticateRequest.verification_idoptional - Made
RadarSmsChallengeCodeSessionAuthenticateRequest.phone_numberoptional - Added enum
CreateUserPasswordSaltPosition - Added enum
UpdateUserPasswordSaltPosition - Added
XOAuthtoAuthenticateResponseAuthenticationMethod - Added
XOAuthtoUserIdentitiesGetItemProvider - Added
GrokOAuthtoAuthenticateResponseAuthenticationMethod - Added
GrokOAuthtoUserIdentitiesGetItemProvider
- Changed errors for endpoint
- webhooks:
- Added
agent.registration.refreshedtoCreateWebhookEndpointEvents - Added
agent.registration.refreshedtoUpdateWebhookEndpointEvents
- Added
Fixes
- pipes:
- Changed the type of
DataIntegration.credentials
- Changed the type of
- user_management:
- Changed errors for endpoint
POST /user_management/authenticate - Changed errors for endpoint
POST /user_management/users - Changed errors for endpoint
PUT /user_management/users/{id}
- Changed errors for endpoint
- events:
-
-
v9.1.030 Jul 2026Release notes
Open source →Features
-
pkce: Default clientId to the client's configured client ID (#423) (f65713b)
-
#425 fix(generated): regenerate from spec
Features
- pipes:
- Added
configtoDataIntegrationsGetDataIntegrationAuthorizeUrlRequest - Added
client_credentialstoDataIntegrationAuthMethods - Added
client_credentialstoDataIntegrationsListResponseDataAuthMethods - Added
client_credentialstoDataIntegrationsListResponseDataConnectedAccountAuthMethod - Added
configto Pipes models
- Added
- connect:
- Added
client_credentialstoConnectedAccountAuthMethod
- Added
Fixes
- user_management:
- Changed errors for endpoint
POST /user_management/invitations - Changed errors for endpoint
POST /user_management/invitations/{id}/resend - Changed errors for endpoint
POST /user_management/magic_auth - Changed errors for endpoint
POST /user_management/authenticate
- Changed errors for endpoint
- pipes:
-
#426 fix(generated): regenerate from spec
Fixes
- sso:
- Removed
callback_endpointfromConnection
- Removed
- sso:
Release notes
Open source →Features
-
pkce: Default clientId to the client's configured client ID (#423) (f65713b)
-
#425 fix(generated): regenerate from spec
Features
- pipes:
- Added
configtoDataIntegrationsGetDataIntegrationAuthorizeUrlRequest - Added
client_credentialstoDataIntegrationAuthMethods - Added
client_credentialstoDataIntegrationsListResponseDataAuthMethods - Added
client_credentialstoDataIntegrationsListResponseDataConnectedAccountAuthMethod - Added
configto Pipes models
- Added
- connect:
- Added
client_credentialstoConnectedAccountAuthMethod
- Added
Fixes
- user_management:
- Changed errors for endpoint
POST /user_management/invitations - Changed errors for endpoint
POST /user_management/invitations/{id}/resend - Changed errors for endpoint
POST /user_management/magic_auth - Changed errors for endpoint
POST /user_management/authenticate
- Changed errors for endpoint
- pipes:
-
#426 fix(generated): regenerate from spec
Fixes
- sso:
- Removed
callback_endpointfromConnection
- Removed
- sso:
-
-
v9.0.022 Jul 2026Release notes
Open source →Miscellaneous Chores
-
deps: update actions/cache action to v5.1.0 (#419) (d963179)
-
prevent oagen generated files from being PR'ed (26d03a0)
-
scope SDK bot App token permissions (293b5ef)
-
#420 fix(generated): regenerate from spec
Features
- audit_logs:
- Added
expiredtoAuditLogExportState
- Added
- audit_logs:
-
#421 feat(generated)!: regenerate from spec (3 changes)
Features
- agents:
- Added model
ClaimViewResponse - Added model
ClaimViewResponseOrganization - Added model
AgentAdminLinkClaimAttemptToExternalUserRequest - Added model
AgentAdminLinkClaimAttemptToExternalUserRequestUser - Added enum
ClaimViewResponseStatus - Added endpoint
PATCH /agents/claims/attempts - Added model
AgentRegistration - Added model
AgentCredentialValidation - Added model
AgentRegistrationAgentIdentity - Added model
AgentRegistrationClaim - Added model
AgentAdminValidateCredentialRequest - Added model
AgentRegistrationClaimClaimCompletion - Added enum
AgentRegistrationStatus - Added enum
AgentRegistrationKind - Added enum
AgentAdminValidateCredentialRequestType - Added service
Agents
- Added model
- api_keys:
- Added
agent_registration_idtoApiKeyValidationResponse
- Added
- connect:
- Added enum
ApplicationsRegistrationTypes - Added parameter
Applications.list.registration_types
- Added enum
- directory_sync:
- Added parameter
DirectoryUsers.list.idp_id - Added parameter
DirectoryUsers.list.email
- Added parameter
- organizations:
- Added model
OrganizationAuthorizedConnectApplicationList - Added model
OrganizationAuthorizedConnectApplicationListData - Added model
OrganizationAuthorizedConnectApplicationListListMetadata - Added service
OrganizationsAuthorizedApplications
- Added model
- pipes:
- Added model
DataIntegrationInstallation - Added
auth_methodstoCreateDataIntegration - Added
api_keytoCreateDataIntegration - Added
api_keytoUpdateDataIntegration - Added
auth_methodstoDataIntegration - Added
installationtoDataIntegration - Added enum
CreateDataIntegrationAuthMethods - Added enum
DataIntegrationAuthMethods - Added model
DataIntegrationCredentialsResponse - Added model
DataIntegrationCredentialsResponseCredential - Added model
DataIntegrationsUpsertApiKeyRequest - Added model
DataIntegrationsVendCredentialsRequest - Added enum
DataIntegrationCredentialsResponseError - Added endpoint
PUT /data-integrations/{slug}/api-key - Added endpoint
POST /data-integrations/{slug}/credentials
- Added model
- sso:
- Added parameter
SSO.authorize.prompt
- Added parameter
- user_management:
- Added
ssha256toCreateUserPasswordHashType - Added
ssha256toUpdateUserPasswordHashType - Added endpoint
GET /user_management/radar_challenges/{id}
- Added
- webhooks:
- Added
agent.registration.revokedtoCreateWebhookEndpointEvents - Added
agent.registration.revokedtoUpdateWebhookEndpointEvents - Added
agent.registration.deletedtoCreateWebhookEndpointEvents - Added
agent.registration.deletedtoUpdateWebhookEndpointEvents - Added
radar.challenge_createdtoCreateWebhookEndpointEvents - Added
radar.challenge_createdtoUpdateWebhookEndpointEvents - Added
agent.registration.expiredtoCreateWebhookEndpointEvents - Added
agent.registration.expiredtoUpdateWebhookEndpointEvents
- Added
- widgets:
- Made
WidgetSessionToken.organization_idoptional
- Made
- agents:
-
#422 feat(generated)!: regenerate from spec (5 changes)
⚠️ Breaking
- admin_portal:
- SDK surface change: Symbol "IntentOptions" was removed
- connect:
- SDK surface change: Symbol "ConnectedAccountDto" was removed
- organization_domains:
- SDK surface change: Symbol "DomainVerificationIntentOptions" was removed
- pipes:
- SDK surface change: Symbol "DataIntegrationCredentialsDto" was removed
- sso:
- SDK surface change: Symbol "SSOIntentOptions" was removed
- admin_portal:
Release notes
Open source →Miscellaneous Chores
-
deps: update actions/cache action to v5.1.0 (#419) (d963179)
-
prevent oagen generated files from being PR'ed (26d03a0)
-
scope SDK bot App token permissions (293b5ef)
-
#420 fix(generated): regenerate from spec
Features
- audit_logs:
- Added
expiredtoAuditLogExportState
- Added
- audit_logs:
-
#421 feat(generated)!: regenerate from spec (3 changes)
Features
- agents:
- Added model
ClaimViewResponse - Added model
ClaimViewResponseOrganization - Added model
AgentAdminLinkClaimAttemptToExternalUserRequest - Added model
AgentAdminLinkClaimAttemptToExternalUserRequestUser - Added enum
ClaimViewResponseStatus - Added endpoint
PATCH /agents/claims/attempts - Added model
AgentRegistration - Added model
AgentCredentialValidation - Added model
AgentRegistrationAgentIdentity - Added model
AgentRegistrationClaim - Added model
AgentAdminValidateCredentialRequest - Added model
AgentRegistrationClaimClaimCompletion - Added enum
AgentRegistrationStatus - Added enum
AgentRegistrationKind - Added enum
AgentAdminValidateCredentialRequestType - Added service
Agents
- Added model
- api_keys:
- Added
agent_registration_idtoApiKeyValidationResponse
- Added
- connect:
- Added enum
ApplicationsRegistrationTypes - Added parameter
Applications.list.registration_types
- Added enum
- directory_sync:
- Added parameter
DirectoryUsers.list.idp_id - Added parameter
DirectoryUsers.list.email
- Added parameter
- organizations:
- Added model
OrganizationAuthorizedConnectApplicationList - Added model
OrganizationAuthorizedConnectApplicationListData - Added model
OrganizationAuthorizedConnectApplicationListListMetadata - Added service
OrganizationsAuthorizedApplications
- Added model
- pipes:
- Added model
DataIntegrationInstallation - Added
auth_methodstoCreateDataIntegration - Added
api_keytoCreateDataIntegration - Added
api_keytoUpdateDataIntegration - Added
auth_methodstoDataIntegration - Added
installationtoDataIntegration - Added enum
CreateDataIntegrationAuthMethods - Added enum
DataIntegrationAuthMethods - Added model
DataIntegrationCredentialsResponse - Added model
DataIntegrationCredentialsResponseCredential - Added model
DataIntegrationsUpsertApiKeyRequest - Added model
DataIntegrationsVendCredentialsRequest - Added enum
DataIntegrationCredentialsResponseError - Added endpoint
PUT /data-integrations/{slug}/api-key - Added endpoint
POST /data-integrations/{slug}/credentials
- Added model
- sso:
- Added parameter
SSO.authorize.prompt
- Added parameter
- user_management:
- Added
ssha256toCreateUserPasswordHashType - Added
ssha256toUpdateUserPasswordHashType - Added endpoint
GET /user_management/radar_challenges/{id}
- Added
- webhooks:
- Added
agent.registration.revokedtoCreateWebhookEndpointEvents - Added
agent.registration.revokedtoUpdateWebhookEndpointEvents - Added
agent.registration.deletedtoCreateWebhookEndpointEvents - Added
agent.registration.deletedtoUpdateWebhookEndpointEvents - Added
radar.challenge_createdtoCreateWebhookEndpointEvents - Added
radar.challenge_createdtoUpdateWebhookEndpointEvents - Added
agent.registration.expiredtoCreateWebhookEndpointEvents - Added
agent.registration.expiredtoUpdateWebhookEndpointEvents
- Added
- widgets:
- Made
WidgetSessionToken.organization_idoptional
- Made
- agents:
-
#422 feat(generated)!: regenerate from spec (5 changes)
⚠️ Breaking
- admin_portal:
- SDK surface change: Symbol "IntentOptions" was removed
- connect:
- SDK surface change: Symbol "ConnectedAccountDto" was removed
- organization_domains:
- SDK surface change: Symbol "DomainVerificationIntentOptions" was removed
- pipes:
- SDK surface change: Symbol "DataIntegrationCredentialsDto" was removed
- sso:
- SDK surface change: Symbol "SSOIntentOptions" was removed
- admin_portal:
-
-
v8.1.006 Jul 2026Release notes
Open source →-
#416 fix(generated): regenerate from spec
Features
- user_management:
- Added model
UserRoleAssignmentSource - Added
sourcetoUserRoleAssignment - Added enum
UserRoleAssignmentSourceType - Added parameter
UserManagementAuthentication.authorize.max_age - Added endpoint
GET /user_management/cors_origins - Added endpoint
GET /user_management/redirect_uris
- Added model
Fixes
- Restore mistakenly removed CreateMagicAuth logic from previous release
- user_management:
Release notes
Open source →-
#416 fix(generated): regenerate from spec
Features
- user_management:
- Added model
UserRoleAssignmentSource - Added
sourcetoUserRoleAssignment - Added enum
UserRoleAssignmentSourceType - Added parameter
UserManagementAuthentication.authorize.max_age - Added endpoint
GET /user_management/cors_origins - Added endpoint
GET /user_management/redirect_uris
- Added model
Fixes
- Restore mistakenly removed CreateMagicAuth logic from previous release
- user_management:
-
-
v8.0.002 Jul 2026Release notes
Open source →-
#409 fix(generated): regenerate from spec
Features
- pipes:
- Added model
DataIntegrationCredentialsResponse - Added model
DataIntegrationCredentialsResponseCredential - Added model
DataIntegrationsUpsertApiKeyRequest - Added model
DataIntegrationsVendCredentialsRequest - Added enum
DataIntegrationCredentialsResponseError - Added endpoint
PUT /data-integrations/{slug}/api-key - Added endpoint
POST /data-integrations/{slug}/credentials
- Added model
- pipes:
-
#411 feat(generated)!: regenerate from spec (1 change)
⚠️ Breaking
- user_management:
- Removed model
SessionReauthenticated - Removed model
SessionReauthenticatedData - Removed model
SessionReauthenticatedDataImpersonator - Removed enum
SessionReauthenticatedDataAuthMethod - Removed enum
SessionReauthenticatedDataStatus
- Removed model
Features
- webhooks:
- Added
agent.registration.createdtoCreateWebhookEndpointEvents - Added
agent.registration.claim.attempt.createdtoCreateWebhookEndpointEvents - Added
agent.registration.claim.completedtoCreateWebhookEndpointEvents - Added
agent.registration.credential.issuedtoCreateWebhookEndpointEvents - Added
agent.registration.organization.switchedtoCreateWebhookEndpointEvents - Added
authentication.reauthentication_succeededtoCreateWebhookEndpointEvents - Added
agent.registration.createdtoUpdateWebhookEndpointEvents - Added
agent.registration.claim.attempt.createdtoUpdateWebhookEndpointEvents - Added
agent.registration.claim.completedtoUpdateWebhookEndpointEvents - Added
agent.registration.credential.issuedtoUpdateWebhookEndpointEvents - Added
agent.registration.organization.switchedtoUpdateWebhookEndpointEvents - Added
authentication.reauthentication_succeededtoUpdateWebhookEndpointEvents
- Added
- webhooks:
- Added
session.reauthenticatedtoCreateWebhookEndpointEvents - Added
session.reauthenticatedtoUpdateWebhookEndpointEvents
- Added
- webhooks:
- Added
pipes.connected_account.connection_failedtoCreateWebhookEndpointEvents - Added
pipes.connected_account.connection_failedtoUpdateWebhookEndpointEvents
- Added
- user_management:
- Added model
UserRoleAssignmentSource - Added
sourcetoUserRoleAssignment - Added enum
UserRoleAssignmentSourceType - Added parameter
UserManagementAuthentication.authorize.max_age - Added endpoint
GET /user_management/cors_origins - Added endpoint
GET /user_management/redirect_uris
- Added model
- audit_logs:
- Changed the format of
AuditLogExportCreation.range_start - Changed the format of
AuditLogExportCreation.range_end
- Changed the format of
- audit_logs:
- Added
expiredtoAuditLogExportState
- Added
Fixes
- admin_portal:
- Removed
intent_optionsfromGenerateLink
- Removed
- webhooks:
- Removed
session.reauthenticatedfromCreateWebhookEndpointEvents - Removed
session.reauthenticatedfromUpdateWebhookEndpointEvents
- Removed
- user_management:
-
#413 feat(generated): regenerate from spec (1 change)
Features
- pipes:
- Added model
DataIntegrationCredentialsDto - Added model
CustomProviderDefinition - Added model
CreateDataIntegration - Added model
UpdateCustomProviderDefinition - Added model
UpdateDataIntegration - Added model
DataIntegration - Added model
DataIntegrationList - Added model
DataIntegrationListListMetadata - Added model
DataIntegrationCredential - Added model
DataIntegrationCustomProvider - Added enum
DataIntegrationCredentialsType - Added enum
CustomProviderDefinitionAuthenticateVia - Added enum
UpdateCustomProviderDefinitionAuthenticateVia - Added enum
DataIntegrationState - Added enum
DataIntegrationCredentialType - Added enum
DataIntegrationCustomProviderAuthenticateVia - Added endpoint
GET /data-integrations - Added endpoint
POST /data-integrations - Added endpoint
GET /data-integrations/{slug} - Added endpoint
PUT /data-integrations/{slug} - Added endpoint
DELETE /data-integrations/{slug} - Added endpoint
POST /user_management/users/{user_id}/connected_accounts/{slug} - Added endpoint
PUT /user_management/users/{user_id}/connected_accounts/{slug}
- Added model
- pipes:
-
#414 feat(generated): regenerate from spec (2 changes)
Features
- user_management:
- Added model
SendRadarSmsChallenge - Added model
SendRadarSmsChallengeResponse - Added model
UrnWorkosOAuthGrantTypeRadarEmailChallengeCodeSessionAuthenticateRequest - Added model
UrnWorkosOAuthGrantTypeRadarSmsChallengeCodeSessionAuthenticateRequest - Added model
MagicAuthSendMagicAuthCodeAndReturnResponse - Added model
UserCreateResponse - Added
ip_addresstoCreateMagicCodeAndReturn - Added
user_agenttoCreateMagicCodeAndReturn - Added
radar_auth_attempt_idtoCreateMagicCodeAndReturn - Added
signals_idtoCreateMagicCodeAndReturn - Added
ip_addresstoCreateUser - Added
user_agenttoCreateUser - Added
signals_idtoCreateUser - Added
signals_idtoAuthorizationCodeSessionAuthenticateRequest - Added
signals_idtoPasswordSessionAuthenticateRequest - Added
radar_auth_attempt_idtoPasswordSessionAuthenticateRequest - Added
radar_auth_attempt_idtoUrnWorkosOAuthGrantTypeMagicAuthCodeSessionAuthenticateRequest - Added endpoint
POST /user_management/radar_challenges
- Added model
- radar:
- Added
signals_idtoRadarStandaloneAssessRequest
- Added
Fixes
- user_management:
- Changed request body for
UserManagementAuthentication.authenticate - Changed response of
UserManagementUsers.createfromUsertoUserCreateResponse - Changed response of
UserManagementMagicAuth.sendMagicAuthCodeAndReturnfromMagicAuthtoMagicAuthSendMagicAuthCodeAndReturnResponse
- Changed request body for
- user_management:
Release notes
Open source →-
#409 fix(generated): regenerate from spec
Features
- pipes:
- Added model
DataIntegrationCredentialsResponse - Added model
DataIntegrationCredentialsResponseCredential - Added model
DataIntegrationsUpsertApiKeyRequest - Added model
DataIntegrationsVendCredentialsRequest - Added enum
DataIntegrationCredentialsResponseError - Added endpoint
PUT /data-integrations/{slug}/api-key - Added endpoint
POST /data-integrations/{slug}/credentials
- Added model
- pipes:
-
#411 feat(generated)!: regenerate from spec (1 change)
⚠️ Breaking
- user_management:
- Removed model
SessionReauthenticated - Removed model
SessionReauthenticatedData - Removed model
SessionReauthenticatedDataImpersonator - Removed enum
SessionReauthenticatedDataAuthMethod - Removed enum
SessionReauthenticatedDataStatus
- Removed model
Features
- webhooks:
- Added
agent.registration.createdtoCreateWebhookEndpointEvents - Added
agent.registration.claim.attempt.createdtoCreateWebhookEndpointEvents - Added
agent.registration.claim.completedtoCreateWebhookEndpointEvents - Added
agent.registration.credential.issuedtoCreateWebhookEndpointEvents - Added
agent.registration.organization.switchedtoCreateWebhookEndpointEvents - Added
authentication.reauthentication_succeededtoCreateWebhookEndpointEvents - Added
agent.registration.createdtoUpdateWebhookEndpointEvents - Added
agent.registration.claim.attempt.createdtoUpdateWebhookEndpointEvents - Added
agent.registration.claim.completedtoUpdateWebhookEndpointEvents - Added
agent.registration.credential.issuedtoUpdateWebhookEndpointEvents - Added
agent.registration.organization.switchedtoUpdateWebhookEndpointEvents - Added
authentication.reauthentication_succeededtoUpdateWebhookEndpointEvents
- Added
- webhooks:
- Added
session.reauthenticatedtoCreateWebhookEndpointEvents - Added
session.reauthenticatedtoUpdateWebhookEndpointEvents
- Added
- webhooks:
- Added
pipes.connected_account.connection_failedtoCreateWebhookEndpointEvents - Added
pipes.connected_account.connection_failedtoUpdateWebhookEndpointEvents
- Added
- user_management:
- Added model
UserRoleAssignmentSource - Added
sourcetoUserRoleAssignment - Added enum
UserRoleAssignmentSourceType - Added parameter
UserManagementAuthentication.authorize.max_age - Added endpoint
GET /user_management/cors_origins - Added endpoint
GET /user_management/redirect_uris
- Added model
- audit_logs:
- Changed the format of
AuditLogExportCreation.range_start - Changed the format of
AuditLogExportCreation.range_end
- Changed the format of
- audit_logs:
- Added
expiredtoAuditLogExportState
- Added
Fixes
- admin_portal:
- Removed
intent_optionsfromGenerateLink
- Removed
- webhooks:
- Removed
session.reauthenticatedfromCreateWebhookEndpointEvents - Removed
session.reauthenticatedfromUpdateWebhookEndpointEvents
- Removed
- user_management:
-
#413 feat(generated): regenerate from spec (1 change)
Features
- pipes:
- Added model
DataIntegrationCredentialsDto - Added model
CustomProviderDefinition - Added model
CreateDataIntegration - Added model
UpdateCustomProviderDefinition - Added model
UpdateDataIntegration - Added model
DataIntegration - Added model
DataIntegrationList - Added model
DataIntegrationListListMetadata - Added model
DataIntegrationCredential - Added model
DataIntegrationCustomProvider - Added enum
DataIntegrationCredentialsType - Added enum
CustomProviderDefinitionAuthenticateVia - Added enum
UpdateCustomProviderDefinitionAuthenticateVia - Added enum
DataIntegrationState - Added enum
DataIntegrationCredentialType - Added enum
DataIntegrationCustomProviderAuthenticateVia - Added endpoint
GET /data-integrations - Added endpoint
POST /data-integrations - Added endpoint
GET /data-integrations/{slug} - Added endpoint
PUT /data-integrations/{slug} - Added endpoint
DELETE /data-integrations/{slug} - Added endpoint
POST /user_management/users/{user_id}/connected_accounts/{slug} - Added endpoint
PUT /user_management/users/{user_id}/connected_accounts/{slug}
- Added model
- pipes:
-
#414 feat(generated): regenerate from spec (2 changes)
Features
- user_management:
- Added model
SendRadarSmsChallenge - Added model
SendRadarSmsChallengeResponse - Added model
UrnWorkosOAuthGrantTypeRadarEmailChallengeCodeSessionAuthenticateRequest - Added model
UrnWorkosOAuthGrantTypeRadarSmsChallengeCodeSessionAuthenticateRequest - Added model
MagicAuthSendMagicAuthCodeAndReturnResponse - Added model
UserCreateResponse - Added
ip_addresstoCreateMagicCodeAndReturn - Added
user_agenttoCreateMagicCodeAndReturn - Added
radar_auth_attempt_idtoCreateMagicCodeAndReturn - Added
signals_idtoCreateMagicCodeAndReturn - Added
ip_addresstoCreateUser - Added
user_agenttoCreateUser - Added
signals_idtoCreateUser - Added
signals_idtoAuthorizationCodeSessionAuthenticateRequest - Added
signals_idtoPasswordSessionAuthenticateRequest - Added
radar_auth_attempt_idtoPasswordSessionAuthenticateRequest - Added
radar_auth_attempt_idtoUrnWorkosOAuthGrantTypeMagicAuthCodeSessionAuthenticateRequest - Added endpoint
POST /user_management/radar_challenges
- Added model
- radar:
- Added
signals_idtoRadarStandaloneAssessRequest
- Added
Fixes
- user_management:
- Changed request body for
UserManagementAuthentication.authenticate - Changed response of
UserManagementUsers.createfromUsertoUserCreateResponse - Changed response of
UserManagementMagicAuth.sendMagicAuthCodeAndReturnfromMagicAuthtoMagicAuthSendMagicAuthCodeAndReturnResponse
- Changed request body for
- user_management:
-
-
v7.3.030 Jun 2026Release notes
Open source →-
#405 fix(generated): regenerate from spec
Fixes
- organization_membership:
- Added
rolesto organization membership models
- Added
- organization_membership:
Release notes
Open source →-
#405 fix(generated): regenerate from spec
Fixes
- organization_membership:
- Added
rolesto organization membership models
- Added
- organization_membership:
-
-
v7.2.018 Jun 2026Release notes
Open source →Bug Fixes
Miscellaneous Chores
- commit publishing fixes (c7ba478)
-
#401 feat(generated)!: regenerate from spec (11 changes)
⚠️ Breaking
- pipes:
- SDK surface change:
Pipes.createDataIntegrationTokenwas renamed toPipes.getAccessToken
- SDK surface change:
Features
- authorization:
- Added model
ReplaceGroupRoleAssignmentEntry - Added model
ReplaceGroupRoleAssignments - Added model
DeleteGroupRoleAssignmentsByCriteria - Added endpoint
POST /authorization/groups/{group_id}/role_assignments - Added endpoint
PUT /authorization/groups/{group_id}/role_assignments - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments - Added endpoint
GET /authorization/groups/{group_id}/role_assignments/{role_assignment_id} - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments/{role_assignment_id}
- Added model
- client:
- Added model
ClientApiToken - Added model
ClientApiTokenResponse - Added service
Client
- Added model
- connect:
- Added
auth_methodtoConnectedAccount - Added
api_key_last_4toConnectedAccount - Added enum
ConnectedAccountAuthMethod
- Added
- groups:
- Added model
CreateGroupRoleAssignment - Added model
GroupRoleAssignment - Added model
GroupRoleAssignmentList - Added model
GroupRoleAssignmentResource
- Added model
- organization_membership:
- Added model
UserOrganizationMembershipList - Added model
UserOrganizationMembershipListListMetadata
- Added model
- pipes:
- Added model
DataIntegrationCredentials - Added model
DataIntegrationConfigurationResponse - Added model
DataIntegrationConfigurationListResponse - Added model
ConfigureDataIntegrationBody - Added
auth_methodstoDataIntegrationsListResponseData - Added
auth_methodtoDataIntegrationsListResponseDataConnectedAccount - Added
api_key_last_4toDataIntegrationsListResponseDataConnectedAccount - Added enum
DataIntegrationCredentialsCredentialsType - Added enum
DataIntegrationsListResponseDataAuthMethods - Added enum
DataIntegrationsListResponseDataConnectedAccountAuthMethod - Added service
PipesProvider
- Added model
- user_management:
- Added model
UserInviteList - Added model
UserInviteListListMetadata - Made
AuthorizationCodeSessionAuthenticateRequest.client_secretoptional - Made
RefreshTokenSessionAuthenticateRequest.client_secretoptional
- Added model
- widgets:
- Added
widgets:pipes:managetoWidgetSessionTokenScopes
- Added
Fixes
- organization_membership:
- Changed response of
UserManagementOrganizationMembership.listfromUserOrganizationMembershiptoUserOrganizationMembershipList
- Changed response of
- user_management:
- Changed response of
UserManagementInvitations.listfromUserInvitetoUserInviteList
- Changed response of
- pipes:
Release notes
Open source →Bug Fixes
Miscellaneous Chores
- commit publishing fixes (c7ba478)
-
#401 feat(generated)!: regenerate from spec (11 changes)
⚠️ Breaking
- pipes:
- SDK surface change:
Pipes.createDataIntegrationTokenwas renamed toPipes.getAccessToken
- SDK surface change:
Features
- authorization:
- Added model
ReplaceGroupRoleAssignmentEntry - Added model
ReplaceGroupRoleAssignments - Added model
DeleteGroupRoleAssignmentsByCriteria - Added endpoint
POST /authorization/groups/{group_id}/role_assignments - Added endpoint
PUT /authorization/groups/{group_id}/role_assignments - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments - Added endpoint
GET /authorization/groups/{group_id}/role_assignments/{role_assignment_id} - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments/{role_assignment_id}
- Added model
- client:
- Added model
ClientApiToken - Added model
ClientApiTokenResponse - Added service
Client
- Added model
- connect:
- Added
auth_methodtoConnectedAccount - Added
api_key_last_4toConnectedAccount - Added enum
ConnectedAccountAuthMethod
- Added
- groups:
- Added model
CreateGroupRoleAssignment - Added model
GroupRoleAssignment - Added model
GroupRoleAssignmentList - Added model
GroupRoleAssignmentResource
- Added model
- organization_membership:
- Added model
UserOrganizationMembershipList - Added model
UserOrganizationMembershipListListMetadata
- Added model
- pipes:
- Added model
DataIntegrationCredentials - Added model
DataIntegrationConfigurationResponse - Added model
DataIntegrationConfigurationListResponse - Added model
ConfigureDataIntegrationBody - Added
auth_methodstoDataIntegrationsListResponseData - Added
auth_methodtoDataIntegrationsListResponseDataConnectedAccount - Added
api_key_last_4toDataIntegrationsListResponseDataConnectedAccount - Added enum
DataIntegrationCredentialsCredentialsType - Added enum
DataIntegrationsListResponseDataAuthMethods - Added enum
DataIntegrationsListResponseDataConnectedAccountAuthMethod - Added service
PipesProvider
- Added model
- user_management:
- Added model
UserInviteList - Added model
UserInviteListListMetadata - Made
AuthorizationCodeSessionAuthenticateRequest.client_secretoptional - Made
RefreshTokenSessionAuthenticateRequest.client_secretoptional
- Added model
- widgets:
- Added
widgets:pipes:managetoWidgetSessionTokenScopes
- Added
Fixes
- organization_membership:
- Changed response of
UserManagementOrganizationMembership.listfromUserOrganizationMembershiptoUserOrganizationMembershipList
- Changed response of
- user_management:
- Changed response of
UserManagementInvitations.listfromUserInvitetoUserInviteList
- Changed response of
- pipes:
-
v7.1.017 Jun 2026Release notes
Open source →Miscellaneous Chores
-
#397 feat(generated)!: regenerate from spec (5 changes)
⚠️ Breaking
- api_keys:
- Made
expires_atrequired in API key models
- Made
- directory_sync:
- Removed model
DsyncDeactivated - Removed model
DsyncDeactivatedData - Removed model
DsyncDeactivatedDataDomain - Removed enum
DsyncDeactivatedDataType - Removed enum
DsyncDeactivatedDataState
- Removed model
- radar:
- Removed
domain_sign_up_rate_limitfromRadarStandaloneResponseControl
- Removed
- user_management:
- Removed
return_tofromRevokeSession
- Removed
Features
- api_keys:
- Added model
ExpireApiKey - Added model
ApiKeyUpdated - Added model
ApiKeyUpdatedData - Added model
ApiKeyUpdatedDataOwner - Added model
UserApiKeyUpdatedDataOwner - Added model
ApiKeyUpdatedDataPreviousAttribute - Added endpoint
POST /api_keys/{id}/expire
- Added model
- audit_logs:
- Added
SnowflaketoAuditLogConfigurationLogStreamType
- Added
- connect:
- Added
nametoUserObject
- Added
- directory_sync:
- Added model
DsyncTokenCreated - Added model
DsyncTokenCreatedData - Added model
DsyncTokenRevoked - Added model
DsyncTokenRevokedData
- Added model
- user_management:
- Added
nameto user management models
- Added
- webhooks:
- Added
api_key.updatedtoCreateWebhookEndpointEvents - Added
api_key.updatedtoUpdateWebhookEndpointEvents
- Added
- api_keys:
Release notes
Open source →Miscellaneous Chores
-
#397 feat(generated)!: regenerate from spec (5 changes)
⚠️ Breaking
- api_keys:
- Made
expires_atrequired in API key models
- Made
- directory_sync:
- Removed model
DsyncDeactivated - Removed model
DsyncDeactivatedData - Removed model
DsyncDeactivatedDataDomain - Removed enum
DsyncDeactivatedDataType - Removed enum
DsyncDeactivatedDataState
- Removed model
- radar:
- Removed
domain_sign_up_rate_limitfromRadarStandaloneResponseControl
- Removed
- user_management:
- Removed
return_tofromRevokeSession
- Removed
Features
- api_keys:
- Added model
ExpireApiKey - Added model
ApiKeyUpdated - Added model
ApiKeyUpdatedData - Added model
ApiKeyUpdatedDataOwner - Added model
UserApiKeyUpdatedDataOwner - Added model
ApiKeyUpdatedDataPreviousAttribute - Added endpoint
POST /api_keys/{id}/expire
- Added model
- audit_logs:
- Added
SnowflaketoAuditLogConfigurationLogStreamType
- Added
- connect:
- Added
nametoUserObject
- Added
- directory_sync:
- Added model
DsyncTokenCreated - Added model
DsyncTokenCreatedData - Added model
DsyncTokenRevoked - Added model
DsyncTokenRevokedData
- Added model
- user_management:
- Added
nameto user management models
- Added
- webhooks:
- Added
api_key.updatedtoCreateWebhookEndpointEvents - Added
api_key.updatedtoUpdateWebhookEndpointEvents
- Added
- api_keys:
-
-
v7.0.128 May 2026 -
v7.0.026 May 2026Release notes
Open source →Miscellaneous Chores
-
deps: update googleapis/release-please-action action to v5 (#389) (f973f21)
-
deps: update shivammathur/setup-php action to v2.37.0 (#388) (f9e113f)
-
use shared workos/renovate-config preset (99aad6c)
-
#392 feat(generated)!: regenerate from spec (10 changes)
⚠️ Breaking
- user_management: Remove organization membership methods from UserManagement service
- Removed
listOrganizationMemberships,createOrganizationMembership,getOrganizationMembership,updateOrganizationMembership,deleteOrganizationMembership,deactivateOrganizationMembership, andreactivateOrganizationMembershipmethods - These methods have been moved to the new
OrganizationMembershipService - Change to
getAuthorizationUrl()parameterscreenHintfromUserManagementAuthenticationScreenHinttoRadarStandaloneAssessRequestActiontype - Removed
UserManagementAuthenticationScreenHintenum
- Removed
- user_management: Remove
UserManagementOrganizationMembershipGroupsservice- Removed
$workos->userManagementOrganizationMembershipGroups()accessor listOrganizationMembershipGroups()has been moved to the newOrganizationMembershipService
- Removed
- radar: Remove device fingerprint and bot score from RadarStandaloneAssessRequest
- Removed
deviceFingerprintparameter fromRadar.createAttempt()method - Removed
botScoreparameter fromRadar.createAttempt()method - Removed
deviceFingerprintandbotScorefields fromRadarStandaloneAssessRequestmodel - Removed deprecated enum values from
RadarStandaloneAssessRequestAction:Login,Signup,SignUp2,SignUp3,SignIn2,SignIn3 - Changed enum values in
RadarStandaloneAssessRequestAction:SignUpfrom 'sign up' to 'sign-up',SignInfrom 'sign in' to 'sign-in' - Removed enum values from
RadarStandaloneResponseControl:CredentialStuffing,IpSignUpRateLimit
- Removed
- radar: Rename Radar list enums
- Renamed
RadarActiontoRadarListAction - Renamed
RadarTypetoRadarListType
- Renamed
- audit_logs: Rename audit log models for consistency
- Renamed
AuditLogActionJsontoAuditLogAction - Renamed
AuditLogExportJsontoAuditLogExport - Renamed
AuditLogExportJsonStatetoAuditLogExportState - Renamed
AuditLogSchemaJsontoAuditLogSchema - Renamed
AuditLogSchemaJsonActortoAuditLogSchemaActorInput - Renamed
AuditLogSchemaJsonTargettoAuditLogSchemaTargetInput - Renamed
AuditLogsRetentionJsontoAuditLogsRetention createSchema()method parameter types changed:AuditLogSchemaActor→AuditLogSchemaActorInput,AuditLogSchemaTarget→AuditLogSchemaTargetInput
- Renamed
- webhooks: Rename webhook endpoint models and update status field type
- Renamed
WebhookEndpointJsontoWebhookEndpoint - Renamed
WebhookEndpointJsonStatustoWebhookEndpointStatus - Changed
UpdateWebhookEndpoint.statusfield type fromWebhookEndpointJsonStatustoWebhookEndpointStatus - Updated webhook event enums: added
PIPES_CONNECTED_ACCOUNT_CONNECTED,PIPES_CONNECTED_ACCOUNT_DISCONNECTED,PIPES_CONNECTED_ACCOUNT_REAUTHORIZATION_NEEDEDevents
- Renamed
- authorization: Update Authorization API with new filters and remove search parameter
- Added
resourceId,resourceExternalId,resourceTypeSlugfilter parameters tolistRoleAssignments() - Added
roleSlugfilter parameter tolistRoleAssignmentsForResourceByExternalId()andlistRoleAssignmentsForResource() - Removed
searchparameter fromlistResources()method
- Added
- vault: Replace hand-maintained
WorkOS\Vaultclass with generatedWorkOS\Service\Vault- The old
WorkOS\Vaultclass (lib/Vault.php) with client-side encrypt/decrypt helpers has been removed $workos->vault()now returnsWorkOS\Service\Vaultwith a different API surface- New generated methods:
createDataKey(),createDecrypt(),createRekey(),listKv(),createKv(),getName(),getKv(),updateKv(),deleteKv(),listKvMetadata(),listKvVersions()
- The old
Features
- organization_membership: Introduce OrganizationMembershipService with membership and group operations
- New service
OrganizationMembershipServicewith methods:listOrganizationMemberships(),createOrganizationMembership(),getOrganizationMembership(),updateOrganizationMembership(),deleteOrganizationMembership(),deactivateOrganizationMembership(),reactivateOrganizationMembership(), andlistOrganizationMembershipGroups() - Accessible via
$workos->organizationMembership() - Replaces functionality previously in
UserManagementandUserManagementOrganizationMembershipGroupsservices
- New service
- vault: Add new Vault service for encrypted key-value storage
- New
Vaultservice with methods:createDataKey(),createDecrypt(),createRekey(),listKv(),createKv(),getName(),getKv(),updateKv(),deleteKv(),listKvMetadata(), andlistKvVersions() - Support for encrypted object storage and management with key rotation
- New models:
CreateDataKeyResponse,DecryptResponse,ObjectMetadata,ObjectModel,ObjectSummary,ObjectWithoutValue,ObjectVersion,VersionListResponse - New enum:
VaultOrderfor sort direction - Accessible via
$workos->vault()
- New
- api_keys: Add expires_at field to API key models and creation methods
- Added
expires_atfield toApiKey,OrganizationApiKey,OrganizationApiKeyWithValue,UserApiKey,UserApiKeyWithValuemodels - Added
expires_atfield toApiKeyCreatedDataandApiKeyRevokedDataevent data models - Added optional
expiresAtparameter tocreateOrganizationApiKey()andcreateUserApiKey()methods - Support for setting API key expiration timestamps
- Added
- applications: Update ApplicationCredentialsListItem and NewConnectApplicationSecret field types
- Changed
ApplicationCredentialsListItem.lastUsedAtfield type from?stringto?\DateTimeImmutable - Changed
NewConnectApplicationSecret.lastUsedAtfield type from?stringto?\DateTimeImmutable
- Changed
- pipes: Add connected account event models and related types
- New models for pipe events:
PipeConnectedAccount,PipesConnectedAccountConnected,PipesConnectedAccountDisconnected,PipesConnectedAccountReauthorizationNeeded - New enum:
PipeConnectedAccountStatewith valuesconnectedandneeds_reauthorization - Support for monitoring data integration connection status changes
- New models for pipe events:
- user_management: Remove organization membership methods from UserManagement service
Release notes
Open source →Miscellaneous Chores
-
deps: update googleapis/release-please-action action to v5 (#389) (f973f21)
-
deps: update shivammathur/setup-php action to v2.37.0 (#388) (f9e113f)
-
use shared workos/renovate-config preset (99aad6c)
-
#392 feat(generated)!: regenerate from spec (10 changes)
⚠️ Breaking
- user_management: Remove organization membership methods from UserManagement service
- Removed
listOrganizationMemberships,createOrganizationMembership,getOrganizationMembership,updateOrganizationMembership,deleteOrganizationMembership,deactivateOrganizationMembership, andreactivateOrganizationMembershipmethods - These methods have been moved to the new
OrganizationMembershipService - Change to
getAuthorizationUrl()parameterscreenHintfromUserManagementAuthenticationScreenHinttoRadarStandaloneAssessRequestActiontype - Removed
UserManagementAuthenticationScreenHintenum
- Removed
- user_management: Remove
UserManagementOrganizationMembershipGroupsservice- Removed
$workos->userManagementOrganizationMembershipGroups()accessor listOrganizationMembershipGroups()has been moved to the newOrganizationMembershipService
- Removed
- radar: Remove device fingerprint and bot score from RadarStandaloneAssessRequest
- Removed
deviceFingerprintparameter fromRadar.createAttempt()method - Removed
botScoreparameter fromRadar.createAttempt()method - Removed
deviceFingerprintandbotScorefields fromRadarStandaloneAssessRequestmodel - Removed deprecated enum values from
RadarStandaloneAssessRequestAction:Login,Signup,SignUp2,SignUp3,SignIn2,SignIn3 - Changed enum values in
RadarStandaloneAssessRequestAction:SignUpfrom 'sign up' to 'sign-up',SignInfrom 'sign in' to 'sign-in' - Removed enum values from
RadarStandaloneResponseControl:CredentialStuffing,IpSignUpRateLimit
- Removed
- radar: Rename Radar list enums
- Renamed
RadarActiontoRadarListAction - Renamed
RadarTypetoRadarListType
- Renamed
- audit_logs: Rename audit log models for consistency
- Renamed
AuditLogActionJsontoAuditLogAction - Renamed
AuditLogExportJsontoAuditLogExport - Renamed
AuditLogExportJsonStatetoAuditLogExportState - Renamed
AuditLogSchemaJsontoAuditLogSchema - Renamed
AuditLogSchemaJsonActortoAuditLogSchemaActorInput - Renamed
AuditLogSchemaJsonTargettoAuditLogSchemaTargetInput - Renamed
AuditLogsRetentionJsontoAuditLogsRetention createSchema()method parameter types changed:AuditLogSchemaActor→AuditLogSchemaActorInput,AuditLogSchemaTarget→AuditLogSchemaTargetInput
- Renamed
- webhooks: Rename webhook endpoint models and update status field type
- Renamed
WebhookEndpointJsontoWebhookEndpoint - Renamed
WebhookEndpointJsonStatustoWebhookEndpointStatus - Changed
UpdateWebhookEndpoint.statusfield type fromWebhookEndpointJsonStatustoWebhookEndpointStatus - Updated webhook event enums: added
PIPES_CONNECTED_ACCOUNT_CONNECTED,PIPES_CONNECTED_ACCOUNT_DISCONNECTED,PIPES_CONNECTED_ACCOUNT_REAUTHORIZATION_NEEDEDevents
- Renamed
- authorization: Update Authorization API with new filters and remove search parameter
- Added
resourceId,resourceExternalId,resourceTypeSlugfilter parameters tolistRoleAssignments() - Added
roleSlugfilter parameter tolistRoleAssignmentsForResourceByExternalId()andlistRoleAssignmentsForResource() - Removed
searchparameter fromlistResources()method
- Added
- vault: Replace hand-maintained
WorkOS\Vaultclass with generatedWorkOS\Service\Vault- The old
WorkOS\Vaultclass (lib/Vault.php) with client-side encrypt/decrypt helpers has been removed $workos->vault()now returnsWorkOS\Service\Vaultwith a different API surface- New generated methods:
createDataKey(),createDecrypt(),createRekey(),listKv(),createKv(),getName(),getKv(),updateKv(),deleteKv(),listKvMetadata(),listKvVersions()
- The old
Features
- organization_membership: Introduce OrganizationMembershipService with membership and group operations
- New service
OrganizationMembershipServicewith methods:listOrganizationMemberships(),createOrganizationMembership(),getOrganizationMembership(),updateOrganizationMembership(),deleteOrganizationMembership(),deactivateOrganizationMembership(),reactivateOrganizationMembership(), andlistOrganizationMembershipGroups() - Accessible via
$workos->organizationMembership() - Replaces functionality previously in
UserManagementandUserManagementOrganizationMembershipGroupsservices
- New service
- vault: Add new Vault service for encrypted key-value storage
- New
Vaultservice with methods:createDataKey(),createDecrypt(),createRekey(),listKv(),createKv(),getName(),getKv(),updateKv(),deleteKv(),listKvMetadata(), andlistKvVersions() - Support for encrypted object storage and management with key rotation
- New models:
CreateDataKeyResponse,DecryptResponse,ObjectMetadata,ObjectModel,ObjectSummary,ObjectWithoutValue,ObjectVersion,VersionListResponse - New enum:
VaultOrderfor sort direction - Accessible via
$workos->vault()
- New
- api_keys: Add expires_at field to API key models and creation methods
- Added
expires_atfield toApiKey,OrganizationApiKey,OrganizationApiKeyWithValue,UserApiKey,UserApiKeyWithValuemodels - Added
expires_atfield toApiKeyCreatedDataandApiKeyRevokedDataevent data models - Added optional
expiresAtparameter tocreateOrganizationApiKey()andcreateUserApiKey()methods - Support for setting API key expiration timestamps
- Added
- applications: Update ApplicationCredentialsListItem and NewConnectApplicationSecret field types
- Changed
ApplicationCredentialsListItem.lastUsedAtfield type from?stringto?\DateTimeImmutable - Changed
NewConnectApplicationSecret.lastUsedAtfield type from?stringto?\DateTimeImmutable
- Changed
- pipes: Add connected account event models and related types
- New models for pipe events:
PipeConnectedAccount,PipesConnectedAccountConnected,PipesConnectedAccountDisconnected,PipesConnectedAccountReauthorizationNeeded - New enum:
PipeConnectedAccountStatewith valuesconnectedandneeds_reauthorization - Support for monitoring data integration connection status changes
- New models for pipe events:
- user_management: Remove organization membership methods from UserManagement service
-
-
v6.0.211 May 2026Release notes
Open source → -
v6.0.107 May 2026Release notes
Open source → -
6.0.006 May 2026Release notes
Open source →⚠ BREAKING CHANGES
- user_management: Add user API keys and update ordering enum
- api_keys: Restructure API key models and rename ordering enum
- vault: Rename BYOK key provider enum and add vault key deleted event
- authorization: Rename RoleAssignment to UserRoleAssignment
Features
- Add API docs generation and llms.txt index (#382) (ae03f03)
- api_keys: Restructure API key models and rename ordering enum (1bb2fe4)
- authorization: Rename EventsOrder to PaginationOrder (1bb2fe4)
- authorization: Rename RoleAssignment to UserRoleAssignment (1bb2fe4)
- directory_sync: Add name field to directory users (1bb2fe4)
- sso: Add full name support to user profiles (1bb2fe4)
- user_management: Add user API keys and update ordering enum (1bb2fe4)
- user_management: Add user context to organization memberships (1bb2fe4)
- vault: Rename BYOK key provider enum and add vault key deleted event (1bb2fe4)
Bug Fixes
-
5.2.128 Apr 2026Release notes
Open source → -
5.2.027 Apr 2026 -
5.1.020 Apr 2026Release notes
Open source →Features
Bug Fixes
- redesign authorization resource targeting and default order handling (b435ced)
- Remove extractVersion from matchUpdateTypes rules (#365) (f4ad142)
- type tweaks (780ee85)
Miscellaneous Chores
-
5.0.314 Apr 2026 -
5.0.214 Apr 2026 -
5.0.113 Apr 2026 -
5.0.013 Apr 2026Release notes
Open source →Top-Level Notices
- v5 is a major SDK redesign centered on an instantiated
WorkOSclient with service accessors like$workos->sso(),$workos->userManagement(), and$workos->authorization(). Direct use of many legacy top-level service classes and transport internals has been removed or renamed. - The minimum runtime is now PHP 8.2. The SDK now depends on
guzzlehttp/guzzle:^7,paragonie/halite:^5.1, andext-curl:^8.2. - Responses and resources are now typed, generated models, pagination now uses
PaginatedResponse, and named arguments are strongly recommended because many method signatures changed in v5. - The v5 release also expands and reorganizes the SDK surface across areas like Authorization, Audit Logs, Feature Flags, Organization Domains, Connect, Events, Pipes, Radar, API Keys, Session Manager, PKCE, Webhooks, and Vault helpers.
Migration Guide
- For upgrade steps, renamed APIs, and side-by-side examples for moving from v4 to v5, see V5_MIGRATION_GUIDE.
- v5 is a major SDK redesign centered on an instantiated
-
4.32.009 Mar 2026 -
4.30.117 Feb 2026Nothing published for this version
-
4.30.021 Jan 2026Nothing published for this version
-
v4.29.003 Dec 2025Nothing published for this version
-
v4.28.021 Nov 2025Nothing published for this version
-
v4.27.024 Sep 2025Nothing published for this version
-
v4.26.023 Jun 2025Nothing published for this version
-
v4.25.017 Jun 2025Nothing published for this version
-
v4.24.022 May 2025Nothing published for this version
-
v4.23.025 Apr 2025Nothing published for this version
-
v4.22.021 Mar 2025Nothing published for this version
-
v4.21.014 Mar 2025Nothing published for this version
-
v4.20.021 Feb 2025Nothing published for this version
-
v4.19.020 Feb 2025Nothing published for this version
-
v4.18.014 Jan 2025Nothing published for this version
-
v4.17.027 Dec 2024Nothing published for this version
-
v4.16.006 Dec 2024Nothing published for this version
-
v4.15.015 Nov 2024Nothing published for this version
-
v4.14.021 Oct 2024Nothing published for this version
-
v4.13.007 Aug 2024Nothing published for this version
-
v4.12.016 Jul 2024Nothing published for this version
-
v4.11.111 Jul 2024Nothing published for this version
-
v4.11.024 Jun 2024Nothing published for this version
-
v4.10.004 Jun 2024Nothing published for this version
-
v4.9.024 May 2024Nothing published for this version
-
v4.8.122 May 2024Nothing published for this version
-
v4.8.017 May 2024Nothing published for this version
-
v4.7.014 May 2024Nothing published for this version
-
v4.6.003 May 2024Nothing published for this version
-
v4.5.002 May 2024Nothing published for this version
-
v4.4.009 Apr 2024Nothing published for this version
-
v4.3.020 Mar 2024Nothing published for this version
-
v4.2.007 Feb 2024Nothing published for this version
-
v4.1.014 Dec 2023Nothing published for this version
-
v4.0.022 Nov 2023Nothing published for this version
-
v3.4.020 Sep 2023Nothing published for this version
-
v3.3.004 May 2023Nothing published for this version
-
v3.2.013 Apr 2023Nothing published for this version
-
v3.1.130 Mar 2023Nothing published for this version
-
v3.1.007 Mar 2023Nothing published for this version