WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Go SDK

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

May 6, 2025

v4.38.0

Latest
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.
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)