WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Node.js SDK

github.com
workos/workos-node
120 Stars
30 Forks
53 Contributors
github.com
Official Node.js SDK for interacting with the WorkOS API.

Installation

JavaScript

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

November 19, 2024

v7.33.0

Latest
November 19, 2024

What's Changed

  • Add Actions https://github.com/workos/workos-node/pull/1172

Full Changelog: https://github.com/workos/workos-node/compare/v7.32.0...v7.33.0

November 15, 2024

v7.32.0

November 15, 2024

Added

  • Add Passkey to AuthenticationMethod union (#1166)

Full Changelog: https://github.com/workos/workos-node/compare/v7.31.0...v7.32.0

November 14, 2024

v7.31.0

November 14, 2024

What's Changed

  • Add NodeHttpClient and FetchHttpClient tests for retry logic by @stanleyphu in https://github.com/workos/workos-node/pull/1154
  • Remove org Stripe customer ID setter/getter by @dandorman in https://github.com/workos/workos-node/pull/1160
  • Add oauthTokens to AuthenticationResponse by @jonatascastro12 in https://github.com/workos/workos-node/pull/1164
  • Bump version to v7.31.0 by @jonatascastro12 in https://github.com/workos/workos-node/pull/1165

Full Changelog: https://github.com/workos/workos-node/compare/v7.30.1...v7.31.0

November 12, 2024

v7.31.0-beta.actions1

Pre-release
November 12, 2024

What's Changed

  • Add actions support by @faroceann in https://github.com/workos/workos-node/pull/1161

Full Changelog: https://github.com/workos/workos-node/compare/v7.9.0...v7.31.0-beta.actions1

November 6, 2024

v7.30.1

November 6, 2024

What's Changed

  • Throws non-retryable errors in NodeHttpClient https://github.com/workos/workos-node/pull/1155

Full Changelog: https://github.com/workos/workos-node/compare/v7.30.0...v7.30.1

October 25, 2024

v7.30.0

October 25, 2024

What's Changed

  • Added network retries to FGA module https://github.com/workos/workos-node/pull/1134

Full Changelog: https://github.com/workos/workos-node/compare/v7.29.1...v7.30.0

October 24, 2024

v7.29.1

October 24, 2024

Changed

  • Fixed incorrect organization domain interface (https://github.com/workos/workos-node/pull/1145)
    • Updated verificationToken on OrganizationDomain to optional (it was always optional from the API's perspective)
    • Updated Organization deserialization to correctly deserialize verificationToken and verificationStrategy for the organization's domains
October 18, 2024

v7.29.0

October 18, 2024

What's Changed

  • Audit logs create schema by @PaulAsjes in https://github.com/workos/workos-node/pull/1141

Full Changelog: https://github.com/workos/workos-node/compare/v7.28.0...v7.29.0

October 16, 2024

v7.28.0

October 16, 2024

What's Changed

  • Add role to profile in https://github.com/workos/workos-node/pull/1137

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.5...v7.28.0

October 7, 2024

v7.27.5

October 7, 2024

What's Changed

  • Remove emitWarning entirely so Vercel deployments work by @PaulAsjes in https://github.com/workos/workos-node/pull/1139

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.4...v7.27.5

October 2, 2024

v7.27.4

October 2, 2024

What's Changed

  • Update README.md import statement to match API reference by @sheldonvaughn in https://github.com/workos/workos-node/pull/1128
  • Make emitWarning safe for workers by @PaulAsjes in https://github.com/workos/workos-node/pull/1135

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.3...v7.27.4

September 16, 2024

v7.27.3

September 16, 2024

What's Changed

  • Add organization domain events by @PaulAsjes in https://github.com/workos/workos-node/pull/1123

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.2...v7.27.3

September 13, 2024

v7.27.2

September 13, 2024

What's Changed

  • Add serializer for BatchWriteResourcesOptions https://github.com/workos/workos-node/pull/1124
  • Include policy when deserializing WarrantResponse https://github.com/workos/workos-node/pull/1125

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.1...v7.27.2

September 10, 2024

v7.27.1

September 10, 2024

What's Changed

  • Export the correct org domain interface by @PaulAsjes in https://github.com/workos/workos-node/pull/1119

Full Changelog: https://github.com/workos/workos-node/compare/v7.27.0...v7.27.1

September 9, 2024

v7.27.0

September 9, 2024
  • Added context parameter to AuthorizationURLOptions
August 30, 2024

v7.26.0

August 30, 2024

What's Changed

  • Add batchWriteResources method in FGA module https://github.com/workos/workos-node/pull/1117

Full Changelog: https://github.com/workos/workos-node/compare/v7.25.1.0...v7.26.0

August 28, 2024

v7.25.1

August 28, 2024

What's Changed

  • Add scrypt to passwordHashType in user options interfaces by @jonatascastro12 in https://github.com/workos/workos-node/pull/1114

Full Changelog: https://github.com/workos/workos-node/compare/v7.25.0...v7.25.1

August 28, 2024

v7.25.0

August 28, 2024

What's Changed

  • Rework session helpers by @PaulAsjes in https://github.com/workos/workos-node/pull/1105

Full Changelog: https://github.com/workos/workos-node/compare/v7.24.0...v7.25.0

August 26, 2024

v7.24.0

August 26, 2024

Added

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

v7.23.0

August 19, 2024

What's Changed

  • Add certificate_renewal intent for the Admin Portal by @alisherry in https://github.com/workos/workos-node/pull/1104
August 16, 2024

v7.22.1

August 16, 2024

Added

  • Export types for FGA https://github.com/workos/workos-node/pull/1106
August 12, 2024

v7.22.0

August 12, 2024

What's Changed

  • Update refreshAndSealSessionData to accept organizationId by @mthadley in https://github.com/workos/workos-node/pull/1100
  • Add export types for CFW and Next.js 15 by @PaulAsjes in https://github.com/workos/workos-node/pull/1102

Full Changelog: https://github.com/workos/workos-node/compare/v7.21.0...v7.22.0

August 5, 2024

v7.21.0

August 5, 2024

Added

  • Make name optional when updating an organization (#1099)
August 1, 2024

v7.20.0

August 1, 2024

What's Changed

  • Add getLogoutUrlFromSessionCookie helper method (#1097)
  • Fix node:process ReferenceError on workers/edge (1096)

Full Changelog: https://github.com/workos/workos-node/compare/v7.19.0...v7.20.0

July 30, 2024

v7.19.0

July 30, 2024

What's Changed

  • Fix iron-session worker support (#1091)
  • Add test for worker environment (#1092)

Full Changelog: https://github.com/workos/workos-node/compare/v7.18.0...v7.19.0

July 29, 2024

v7.18.0

July 29, 2024

Added

  • Added the organizationId parameter to AuthenticateWithRefreshTokenOptions (#1093)
July 26, 2024

v7.17.1

July 26, 2024

What's Changed

  • Fix invalid session cookie enum name (#1088)

Full Changelog: https://github.com/workos/workos-node/compare/v7.17.0...v7.17.1

July 24, 2024

v7.17.0

July 24, 2024

Added

  • Added support for FGA endpoints https://github.com/workos/workos-node/pull/1077
July 23, 2024

v7.16.0

July 23, 2024

Added

  • Added support for authentication events (#998)
July 23, 2024

v7.15.0

July 23, 2024

Added

  • Simplify AuthKit session handling with new authenticateWithSessionCookie and refreshAndSealSessionData methods, and the ability to optionally seal session data on all authenticateWith* methods (#1078)

Full Changelog: https://github.com/workos/workos-node/compare/v7.14.0...v7.15.0