WorkOS Docs Homepage
SDKs
DashboardSign In
SDKs

Go SDK

github.com
workos/workos-go
35 Stars
13 Forks
32 Contributors
github.com
Official Go SDK for interacting with the WorkOS API.

Installation

Command Line
Go

Releases

v3.0.0

November 22, 2023
November 22, 2023

Removed

  • [Breaking Change] Removed deprecated Audit Trail package (#279)
  • [Breaking Change] Removed beta version of the users package. Stable User Management release coming soon! (#279)

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

v2.4.2

October 27, 2023
October 27, 2023

What's Changed

  • Fix pagination for User Management list endpoints (#267)

v2.4.1

October 23, 2023
October 23, 2023

What's Changed

  • Add User Management Constants

v2.4.0

October 20, 2023
October 20, 2023

What's Changed

  • Add events as string constants

v2.3.0

September 14, 2023
September 14, 2023

What's Changed

  • Rename AuthenticateUserWithToken to AuthenticateUserWithCode https://github.com/workos/workos-go/pull/242
  • Drop session endpoints https://github.com/workos/workos-go/pull/243
  • Remove MagicAuthChallenge from public interface https://github.com/workos/workos-go/pull/244
  • User type updates https://github.com/workos/workos-go/pull/245
  • Fix authenticate methods https://github.com/workos/workos-go/pull/246
  • Add Users.DeleteUser() method https://github.com/workos/workos-go/pull/247
  • Fix Users.UpdateUserPassword() path https://github.com/workos/workos-go/pull/250
  • Update Email Verification methods https://github.com/workos/workos-go/pull/251
  • Rename AuthenticateUserWith_ to AuthenticateWith_ https://github.com/workos/workos-go/pull/252
  • Adds missing tests for AuthenticateWithMagicAuth and SendMagicAuthCode https://github.com/workos/workos-go/pull/253
  • Add users.EnrollAuthFactor() method https://github.com/workos/workos-go/pull/254
  • Add users.ListAuthFactor() method https://github.com/workos/workos-go/pull/255
  • Add users.AuthenticateWithTOTP() method https://github.com/workos/workos-go/pull/256
  • Rename password reset methods https://github.com/workos/workos-go/pull/257
  • Update /users/magic_auth/send to take email rather than email_address https://github.com/workos/workos-go/pull/258
  • Fix SendMagicAuthCode response type https://github.com/workos/workos-go/pull/259
  • Fix users.ListAuthFactor() return type https://github.com/workos/workos-go/pull/260

v2.2.2

August 16, 2023
August 16, 2023

What's Changed

  • Fix grant type on AuthenticateUserWithPasswordOpts in https://github.com/workos/workos-go/pull/240

v2.2.1

August 11, 2023
August 11, 2023

What's Changed

  • (FIX) Add ClientID to AuthenticateUserWithPasswordOpts in https://github.com/workos/workos-go/pull/238

v2.2.0

August 11, 2023
August 11, 2023

What's Changed

  • Introduce User Management package in https://github.com/workos/workos-go/pull/233 https://github.com/workos/workos-go/pull/235 https://github.com/workos/workos-go/pull/236

v2.1.4

July 14, 2023
July 14, 2023

What's Changed

  • Add devbox by @AshGodfrey in https://github.com/workos/workos-go/pull/212
  • Use list_metadata instead of listMetadata for events by @AshGodfrey in https://github.com/workos/workos-go/pull/215

v2.1.3

June 26, 2023
June 26, 2023

What's Changed

  • Changed the Events API (in beta) rangeStart and rangeEnd parameters to range_start and range_end (https://github.com/workos/workos-go/pull/210)

v2.1.2

June 14, 2023
June 14, 2023

What's Changed

  • Added Events API beta

v2.1.1

May 10, 2023
May 10, 2023

What's Changed

  • Add ActorNames/ActorIds to CreateExportOpts by @cmatheson in https://github.com/workos/workos-go/pull/204
  • Add validating state to connection enums by @AshGodfrey in https://github.com/workos/workos-go/pull/205

v2.1.0

March 9, 2023
March 9, 2023

Added

  • Added groups attribute to SSO user profile. This feature is in beta, please reach out to support@workos.com to access this feature. (#200)

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: ChallengeOpts → ChallengeFactorOpts VerifyChallengeOpts.AuthenticationChallengeID → VerifyChallengeOpts.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)
    • GetProfileOptions → GetProfileOpts
    • GetProfileAndTokenOptions → GetProfileAndTokenOpts
    • GetAuthorizationURLOptions → GetAuthorizationURLOpts
    • passwordless.SendSessionOpts.ID → passwordless.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)