WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Go SDK

github.com
workos/workos-go
56 Stars
19 Forks
50 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

March 21, 2025

v4.31.0

Latest
March 21, 2025

What's Changed

  • Add email standard attribute to DirectoryUser and mark deprecated standard attributes (#401)
  • Mark emails, job_title, and username standard attributes as deprecated. Enable the equivalent auto-mapped custom attributes instead (#401)
  • Adds ExternalID and Metadata to users and organizations (#407)

Full Changelog: https://github.com/workos/workos-go/compare/v4.30.0...v4.31.0

February 21, 2025

v4.30.0

February 21, 2025

What's Changed

  • Added LastSignInAt to User (https://github.com/workos/workos-go/pull/398)

Full Changelog: https://github.com/workos/workos-go/compare/v4.29.0...v4.30.0

February 7, 2025

v4.29.0

February 7, 2025

What's Changed

  • Fix typo: deactived -> deactivated by @nicknisi in https://github.com/workos/workos-go/pull/394
  • Add domain_prefix to organization domains by @amygdalama in https://github.com/workos/workos-go/pull/395
  • ron: adding optional query params for PKCE flow by @rarevalo13 in https://github.com/workos/workos-go/pull/392
  • v4.29.0 by @nicknisi in https://github.com/workos/workos-go/pull/396

New Contributors

  • @nicknisi made their first contribution in https://github.com/workos/workos-go/pull/394

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

January 15, 2025

v4.28.0

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)