Installation

Command Line
cURL

Releases

v3.0.0

February 2, 2023
February 2, 2023

Breaking Changes

PHP 7.3.0 and above required

Other Changes

Updated syntax for PHP 8.2 compatibility re: https://wiki.php.net/rfc/deprecate_dollar_brace_string_interpolation

Added @property annotation to Profile and ProfileAndToken classes in order to have autocompletion from PHPStorm or for static analysis tools like PHPStan. This way, both understand the syntax

v2.1.0

December 8, 2022
December 8, 2022

Added

  • Add log_streams Admin Portal intent (https://github.com/workos/workos-php/pull/131)

v2.0.0

November 17, 2022
November 17, 2022

Breaking Changes

  • The Profile returned in SSO::getProfileAndToken will now return a profile array (https://workos.com/docs/reference/sso/profile) with values using camelCasing instead of snake_casing (#91) in line with PHP standards and the other workos-php functions.

v1.19.0

November 10, 2022
November 10, 2022

Changed

  • Remove default null value on domain parameter for getAuthorizationUrl function to resolve https://github.com/workos/workos-php/issues/124

Note: This release was mistakenly tagged v1.19.9. If you installed immediately you may see the version downgrade from v1.19.9 -> v1.19.0 on your next composer command.

v1.18.0

October 18, 2022
October 18, 2022

Added

  • Add success_url to generateLink (https://github.com/workos/workos-php/pull/125)
  • Add getFactor and deleteFactor methods to MFA class (https://github.com/workos/workos-php/pull/122)

v1.17.0

October 12, 2022
October 12, 2022

Added

  • Added job title attribute for directory users (#121)

v1.16.0

September 26, 2022
September 26, 2022

Changed

  • Improved error handling to return detailed error message from the API
  • Resolves https://github.com/workos/workos-php/issues/108

v1.15.0

September 26, 2022
September 26, 2022

Added

  • Add support for Idempotency-Key on Create Organization method
  • Add support for primaryEmail function on DirectoryUser class

v1.14.0

September 16, 2022
September 16, 2022

Added

  • Added support for creating Admin Portal links for viewing Audit Logs (#114)

v1.13.0

September 6, 2022
September 6, 2022

Added

  • Added Client for AuditLogs features: createEvent, createExport, and getExport (#110)

v1.12.0

July 14, 2022
July 14, 2022

Added

  • Added directory_id and organization_id to DirectoryGroup and DirectoryUser (#106)

Changed

  • Updated ChallengeFactor and VerifyChallenge endpoints (#105)

v1.11.0

June 21, 2022
June 21, 2022

Added

  • Added null coalesce operator for missing response mappings (#103)

v1.10.0

June 7, 2022
June 7, 2022

Changed

  • Removed environmentId fields (#95)
  • Added order param (#96)
  • Included organization_id in listConnections (#97)
  • Exposed expires_at in totp challenge responses (#101)

v1.9.0

April 13, 2022
April 13, 2022

Changed

  • Split AuthenticationChallenge Resource into AuthenticationChallengeTotp and AuthenticationChallengeSms

v1.8.0

March 30, 2022
March 30, 2022

Added

  • Added MFA API support (#87)

Fixed

  • Used list_metadata instead of ListMetadata (#81)

Changed

  • Updated various dependencies

v1.7.0

February 25, 2022
February 25, 2022

Deprecated

  • Removed environment_id from directory resource as it was no longer needed and sent within the API response

v1.6.0

January 5, 2022
January 5, 2022

Changed

  • Made domain, provider, and connection parameters nullable in the getAuthorizationUrl method for SSO

v1.5.1

December 17, 2021
December 17, 2021

Fixed

  • Fixed a bug in Webhooks::constructEvent that was returning an error when webhooks contained non UTF-8 characters

v1.5.0

December 16, 2021
December 16, 2021

Added

  • Added support for Organization parameter for GetAuthorizationURL function
  • Added support for domain_hint and login_hint parameters for GetAuthorizationURL function

v1.4.0

November 9, 2021
November 9, 2021

Added

  • Added GET Directory function
  • Added Webhook validation function

v1.3.0

October 28, 2021
October 28, 2021

Added

  • Exposed custom_attributes on DirectoryUser (#66)

v1.2.0

September 23, 2021
September 23, 2021

Added

  • Added support for allowProfilesOutsideOrganization to organizations (#61)
  • Added organizationId to profiles (#63)

v1.1.0

July 6, 2021
July 6, 2021

Added

  • Added a getProfile() function

Fixed

  • Fixed an issue with getProfileandToken() returning 'raw' within the profile payload

v1.0.0

May 12, 2021
May 12, 2021

Breaking Changes

  • SSO::getProfile was renamed to SSO::getProfileAndToken (#45)
  • The return type was changed from Profile to ProfileAndToken
  • Organization operations were moved from the Portal class to Organizations (#46)
  • Portal::listOrganizationsOrganizations::listOrganizations
  • Portal::createOrganizationOrganizations::createOrganization
  • Portal::updateOrganizationOrganizations::updateOrganization
  • SSO::createConnection was removed (#47)

Deprecated

  • The deprecated getProjectID and setProjectID methods were fully removed. The getClientID and setClientID methods were used instead (#44)

v0.9.6

May 11, 2021
May 11, 2021

Added

  • Added Update Organization function (#41)

Fixed

  • Fixed a bug with the HTTP DELETE method (#42)

v0.9.5

May 7, 2021
May 7, 2021

Added

  • Added delete HTTP method (#37)

Deprecated

  • Removed the following fields from Connections (#38):
    • oidcClientId
    • oidcClientSecret
    • oidcDiscoveryEndpoint
    • oidcRedirectUri
    • samlEntityId
    • samlIdpUrl
    • samlRelyingPartyPrivateKey
    • samlRelyingPartyPublicKey
    • samlX509Certs
    • oauthUid
    • oauthSecret
    • oauthRedirectUri

V0.9.4

April 23, 2021
April 23, 2021

Fixed

  • Fixed typo in utils/request.php file

Added

  • Added support for illuminate/support versions 5-8 package
  • Added delete directory functionality for directory sync

v0.9.3

April 19, 2021
April 19, 2021

Added

  • Added connection to getAuthorizationUrl (#29)

v0.9.2

March 8, 2021
March 8, 2021

Added

  • Added dsync intent for admin portal

v0.9.0

January 13, 2021
January 13, 2021

Deprecated

  • Removed project ID and added environment ID to EventAction and Directory resources
  • Deprecated project ID in favor of client ID
  • Retired promoteDraftConnection