Go SDK

Installation

Command Line

 go get -u github.com/workos/workos-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

May 20, 2025

v4.40.0

Latest

May 20, 2025

What's Changed

Add Email to UpdateUserOpts by @cmatheson in https://github.com/workos/workos-go/pull/429

added omitempty to ExternalID field by @rarevalo13 in https://github.com/workos/workos-go/pull/428

Bump to v4.40.0 by @rarevalo13 in https://github.com/workos/workos-go/pull/430

Full Changelog: https://github.com/workos/workos-go/compare/v4.39.0...v4.40.0

May 19, 2025

v4.39.0

May 19, 2025

What's Changed

Add "warnings" field to FGA query and check response by @atainter in https://github.com/workos/workos-go/pull/426

Bump to v4.39.0 by @atainter in https://github.com/workos/workos-go/pull/427

Full Changelog: https://github.com/workos/workos-go/compare/v4.38.0...v4.39.0

May 6, 2025

v4.38.0

May 6, 2025

What's Changed

Support optional authenticated data in local encrypt/decrypt by @hexedpackets in https://github.com/workos/workos-go/pull/424

Full Changelog: https://github.com/workos/workos-go/compare/v4.37.0...v4.38.0

April 25, 2025

v4.37.0

April 25, 2025

What's Changed

Add CustomAttributes field to SSO Profile (#422)

Full Changelog: https://github.com/workos/workos-go/compare/v4.36.0...v4.37.0

April 22, 2025

v4.36.0

April 22, 2025

What's Changed

Added password_reset.succeeded event type (https://github.com/workos/workos-go/pull/419)

Full Changelog: https://github.com/workos/workos-go/compare/v4.35.0...v4.36.0

April 15, 2025

v4.35.0

April 15, 2025

What's Changed

Add OrganizationDomains package by @ajworkos in https://github.com/workos/workos-go/pull/412

Alias organization domain types by @ajworkos in https://github.com/workos/workos-go/pull/415

Add endpoints to interact with WorkOS Vault by @hexedpackets in https://github.com/workos/workos-go/pull/418

Full Changelog: https://github.com/workos/workos-go/compare/v4.33.0...v4.35.0

March 25, 2025

v4.33.0

March 25, 2025

What's Changed

Add 'policies' to FGA convert schema response by @atainter in https://github.com/workos/workos-go/pull/411

Full Changelog: https://github.com/workos/workos-go/compare/v4.32.0...v4.33.0

March 24, 2025

v4.32.0

March 24, 2025

What's Changed

ron: adding support for email verification by @rarevalo13 in https://github.com/workos/workos-go/pull/402

Add UpdateSchema and GetSchema to FGA package by @atainter in https://github.com/workos/workos-go/pull/409

Bump to version v4.32.0 by @atainter in https://github.com/workos/workos-go/pull/410

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

March 21, 2025

v4.31.0

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.