Installation

Command Line
cURL

Releases

v2.0.2

January 30, 2023
January 30, 2023

Updates module paths to v2

v2.0.1

December 12, 2022
December 12, 2022

What's Changed

  • Update MFA naming as follows: ChallengeOptsChallengeFactorOpts VerifyChallengeOpts.AuthenticationChallengeIDVerifyChallengeOpts.ChallengeID

Full Changelog: https://github.com/workos/workos-go/compare/v2.0.0...v2.0.1

v2.0.0

December 8, 2022
December 8, 2022

Added

  • Add log_streams Admin Portal intent (https://github.com/workos/workos-go/pull/193)
  • Made #189

Breaking Changes

  • Improve SSO and Passwordless naming consistency (https://github.com/workos/workos-go/pull/193)
    • GetProfileOptionsGetProfileOpts
    • GetProfileAndTokenOptionsGetProfileAndTokenOpts
    • GetAuthorizationURLOptionsGetAuthorizationURLOpts
    • passwordless.SendSessionOpts.IDpasswordless.SendSessionOpts.SessionID
  • mfa: Make client functions more consistent (https://github.com/workos/workos-go/pull/189)
    • All mfa.Client methods now utilize provided ctx.
    • Removed log.Panic in favour of returning errors.
    • All mfa.Client methods now utilize the client's HTTPClient.
    • Added defers for response bodies.
    • Utilize http.Method* constants instead of strings.
    • Have Client.VerifyFactor call it's receiver, not DefaultClient.
  • MFA improvements (https://github.com/workos/workos-go/pull/188)
    • EnrollResponse updated to Factor
    • ChallengeResponse updated to Challenge
    • GetEnrollOpts updated to EnrollFactorOpts
    • VerifyOpts updated to VerifyChallengeOpts
    • Capitalized AuthenticationFactor fields to SMS and TOTP
    • Created type FactorType with SMS and TOTP enums & updated Factor and EnrollFactorOpts accordingly
    • Created TOTPDetails and SMSDetails structs
    • Changed VerifyResponse to be named `VerifyChallengeResponse
  • Standardise return type of VerifyChallenge and coalesce errors into Error (https://github.com/workos/workos-go/pull/187)

v1.21.0

November 14, 2022
November 14, 2022

Changed

  • Add GetLoginHandler to sso.Client (https://github.com/workos/workos-go/pull/180)

v1.20.0

November 11, 2022
November 11, 2022

Changed

  • Cleaned inconsistencies on Audit Logs Client #181 #183

v1.19.0

October 25, 2022
October 25, 2022

Changed

  • Add CreatedAt and UpdatedAt to User in https://github.com/workos/workos-go/pull/175
  • Add support for DeleteFactor and GetFactor methods in https://github.com/workos/workos-go/pull/172
  • Add PrimaryEmail method for Directory User by in https://github.com/workos/workos-go/pull/169

v1.18.0

October 18, 2022
October 18, 2022

Added

  • SuccessURL to GenerateLinkOpts by in https://github.com/workos/workos-go/pull/177

v1.17.0

October 12, 2022
October 12, 2022

Added

  • Added job title attribute to directory user (#173)

v1.16.0

September 16, 2022
September 16, 2022

Added

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

v1.15.0

September 9, 2022
September 9, 2022

What's Changed

  • Add support for optional Idempotency Key in CreateOrganization Method (#166 )

v1.14.0

September 2, 2022
September 2, 2022

Added

  • Added Client for Audit Logs features: CreateEvent, CreateExport, and GetExport (https://github.com/workos/workos-go/pull/164)

v1.13.0

July 14, 2022
July 14, 2022

Added

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

Changed

  • Updated ChallengeFactor and VerifyChallenge endpoints (#160)

v1.12.0

June 10, 2022
June 10, 2022

Changed

  • Updated enum list to current providers
  • Made expires_at non-nullable
  • Mapped all available fields in directory group interface

v1.11.0

May 16, 2022
May 16, 2022

Added

  • Exposed HTTPError struct (#152)

v1.10.0

March 30, 2022
March 30, 2022

Added

  • Added MFA API support (#144)

v1.9.0

March 22, 2022
March 22, 2022

Changed

  • Renamed GitHub org from "workos-inc" to "workos" (#145)

v1.8.0

March 1, 2022
March 1, 2022

Added

  • Added organization_id filter to list directories method (#142)

v1.7.0

January 10, 2022
January 10, 2022

Added

  • Added support for passing an organization to initiate SSO (#139)

Changed

  • Fixed typo in Directory Sync URL (#140)

New Contributors

v1.6.1

December 17, 2021
December 17, 2021

Added

  • Added directory_id and idp_id to directory user, as well as the inactive state constant (#137)

v1.6.0

December 16, 2021
December 16, 2021

Added

  • Added GetDirectory method to retrieve a single Directory (#125)
  • Exposed the ValidatePayload method on the Webhooks client (#129)
  • Added support for domain_hint and login_hint parameters to GetAuthorizationURL (#133)

v1.5.1

December 8, 2021
December 8, 2021

Added

  • Added missing connection types (#130)

v1.5.0

November 15, 2021
November 15, 2021

Added

  • Added webhook signature validation method (#123)

Changed

  • Updated name to email in PasswordlessSession (#127)

v1.4.0

September 23, 2021
September 23, 2021

Added

  • Added CreatedAt and UpdatedAt timestamps to the following resources: (#118)
    • Connection
    • Directory
    • Organization
  • Added support for AllowProfilesOutsideOrganization to organizations (#120)
  • Added OrganizationID to profiles (#121)

Changed

  • Improved error handling around OAuth-style errors (#108)

v1.3.0

August 16, 2021
August 16, 2021

Added

  • Added custom_attributes for Directory Users (#117)

v1.2.1

July 27, 2021
July 27, 2021

Changed

  • Removed internal dependency on gjson (#115)

v1.2.0

July 8, 2021
July 8, 2021

Added

  • Included the organization_id to Directory object

v1.1.0

June 23, 2021
June 23, 2021

Added

  • Added expires_in functionality to the createSession() function used in Magic Link

v1.0.0

May 12, 2021
May 12, 2021

Breaking Changes

  • sso.GetProfile has been renamed to sso.GetProfileAndToken (#100)
    • The return type has also been changed from (Profile, error) to (ProfileAndToken, error)
  • Organization operations have been moved from the portal package to organizations (#101)
    • portal.ListOrganizationsorganizations.ListOrganizations
    • portal.GetOrganizationorganizations.GetOrganization
    • portal.CreateOrganizationorganizations.CreateOrganization
    • portal.UpdateOrganizationorganizations.UpdateOrganization
  • sso.CreateConnection and sso.PromoteDraftConnection have been removed (#102)

v0.10.8

May 11, 2021
May 11, 2021

Added

  • Added support for connection parameter for Create Passwordless Session method
  • Added Get Organization method

Removed

  • Removed deprecated Connection fields

v0.10.7

May 6, 2021
May 6, 2021

Added

  • Added deprecation note for connection status in favor of connection state (both are still supported at this time)
  • Added method to update an organization