WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Go SDK

github.com
workos/workos-go
53 Stars
18 Forks
47 Contributors
github.com
Official Go SDK for interacting with the WorkOS API.

Installation

Command Line
Go

Beta Versions

Certain WorkOS features may be available only in the beta version of the SDK. Beta versions have the -beta.* suffix, for example, 3.2.0-beta.1. For more information on how to use the beta versions, refer to the README in the GitHub repository.

Releases

January 15, 2025

v4.28.0

Latest
January 15, 2025

Added

  • Added ReturnTo option to GetLogoutURLOpts (#390)

Full Changelog: https://github.com/workos/workos-go/compare/v4.27.0...v4.28.0

January 2, 2025

v4.27.0

January 2, 2025

Added

  • Add GET /organization/:orgId/roles API support (#388)

Full Changelog: https://github.com/workos/workos-go/compare/v4.26.0...v4.27.0

December 11, 2024

v4.26.0

December 11, 2024

What's Changed

  • fix: added organization events by @panbanda in https://github.com/workos/workos-go/pull/382
  • Add AuthenticationMethod to AuthenticateResponse. by @dezlitz in https://github.com/workos/workos-go/pull/366

New Contributors

  • @panbanda made their first contribution in https://github.com/workos/workos-go/pull/382
  • @dezlitz made their first contribution in https://github.com/workos/workos-go/pull/366

Full Changelog: https://github.com/workos/workos-go/compare/v4.25.0...v4.26.0

November 15, 2024

v4.25.0

November 15, 2024

Added

  • Add widgets get token API support (#378)

Full Changelog: https://github.com/workos/workos-go/compare/v4.24.0...v4.25.0

November 11, 2024

v4.24.0

November 11, 2024

Added

  • Added OrganizationID, State, VerificationToken, and VerificationStrategy fields to OrganizationDomain struct (https://github.com/workos/workos-go/pull/376)
November 6, 2024

v4.23.0

November 6, 2024

Added

  • Added organization domain events (https://github.com/workos/workos-go/pull/374)
October 21, 2024

v4.22.1

October 21, 2024

What's Changed

  • Add domain_verification intent by @PaulAsjes in https://github.com/workos/workos-go/pull/372

Full Changelog: https://github.com/workos/workos-go/compare/v4.22.0...v4.22.1

October 16, 2024

v4.22.0

October 16, 2024

What's Changed

  • Add "role" to profile in https://github.com/workos/workos-go/pull/367

Full Changelog: https://github.com/workos/workos-go/compare/v4.21.1...v4.22.0

October 16, 2024

v4.21.1

October 16, 2024

Added

  • Added additional event type to fix typo on the DirectoryGroupUserRemoved event
August 28, 2024

v4.21.0

August 28, 2024

Added

  • Added ConvertSchemaToResourceTypes and ConvertResourceTypesToSchema to FGA module (#364)
August 26, 2024

v4.20.0

August 26, 2024

Added

  • Added support for authentication.sso_failed and authentication.oauth_failed events (#362)
August 19, 2024

v4.19.0

August 19, 2024

Added

  • Added certificate_renewal intent by @alisherry https://github.com/workos/workos-go/pull/360
August 12, 2024

v4.18.0

August 12, 2024

Added

  • Added retryable http client and updated FGA module to use it https://github.com/workos/workos-go/pull/356
August 8, 2024

v4.17.0

August 8, 2024

Added

  • Added OrganizationID option for use with AuthenticateWithRefreshToken (#357)
  • Added constants for authentication event types (#337)
July 23, 2024

v4.16.0

July 23, 2024

Added

  • Added support for FGA endpoints https://github.com/workos/workos-go/pull/353

Fixed

  • Fixed json encoding for IdempotencyKey in organizations client
July 22, 2024

v4.15.0

July 22, 2024

Added

  • Added support for Apple and GitHub OAuth https://github.com/workos/workos-go/pull/348
June 20, 2024

v4.14.0

June 20, 2024

Fixed

  • Fixed parameter serialization for the List Invitations method (#350)

Deprecated

  • Marked the AllowProfilesOutsideOrganization option for Organizations as deprecated (#349)
June 4, 2024

v4.13.0

June 4, 2024

Added

  • Added a method to find an invitation using the token (#346)
June 3, 2024

v4.12.0

June 3, 2024

Added

  • Added support for TOTPSecret on usermanagement.EnrollAuthFactor (#345)
  • Added the list identities endpoint and Identity struct to the usermanagement package.
May 28, 2024

v4.11.0

May 28, 2024

Added

  • Added role to Directory User (https://github.com/workos/workos-go/pull/339)
May 24, 2024

v4.10.0

May 24, 2024

Added

  • Added InviterUserID to invitation object returned by API (#340)
  • Add support for email_verification.created and password_reset.created (#340)
  • Added new endpoints to the User Management API to support sending your own emails: GetEmailVerification, GetPasswordReset, and CreatePasswordReset (#340)
  • Deprecation notice for the SendPasswordResetEmail method in favor of CreatePasswordReset (#340)

Removed

  • Removed authentication events (#336)
May 17, 2024

v4.9.0

May 17, 2024

What's Changed

  • Add organization membership deactivate and reactivate API methods by @mattgd in https://github.com/workos/workos-go/pull/334

Full Changelog: https://github.com/workos/workos-go/compare/v4.8.0...v4.9.0

May 3, 2024

v4.8.0

May 3, 2024

Added

  • Added AcceptInvitationUrl to invitation object returned by API (#332)
  • Added new event types: invitation.created and magic_auth.created (#332)
  • Added new endpoints for the Magic Auth API: GetMagicAuth and CreateMagicAuth (#332)
  • Deprecation notice for SendMagicAuthCode method in favor of CreateMagicAuth (#332)
April 30, 2024

v4.7.0

April 30, 2024

Added

  • Support organization_id params in the Events API (https://github.com/workos/workos-go/pull/330)
  • Support organization_membership.added and organization_membership.deleted events (https://github.com/workos/workos-go/pull/328)
  • Add DomainData field to Organization create and update functions and deprecate Domains (https://github.com/workos/workos-go/pull/327)
April 11, 2024

v4.6.0

April 11, 2024

Added

  • Added password_hash and password_hash_type to CreateUser options (#324)

Changed

  • Require the events parameter when calling the list events API for new usages (#325)
April 5, 2024

v4.5.0

April 5, 2024

Added

  • Added optional role_slug parameter to send invitation payload to specify a user's organization membership role when inviting (#322)
April 4, 2024

v4.4.1

April 4, 2024

Changed

  • Fixed parameters organization and connection to organization_id and connection_id (#318)
March 29, 2024

v4.4.0

March 29, 2024

What's Changed

  • Add screen hint to GetAuthorizationURLOpts

Full Changelog: https://github.com/workos/workos-go/compare/v4.3.0...v4.4.0

March 21, 2024

v4.3.0

March 21, 2024

Added

  • Add session.created event (https://github.com/workos/workos-go/pull/313)
March 20, 2024

v4.2.0

March 20, 2024

Removed

  • Remove separate user.impersonated event (https://github.com/workos/workos-go/pull/311)
    • This event was never emitted by the API and has been superseded by session.created.