WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

.NET SDK

github.com
workos/ workos-dotnet
37 Stars
11 Forks
29 Contributors
github.com
Official .NET SDK for interacting with the WorkOS API.

Installation

Command Line
.NET

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 beta versions, refer to the README in the GitHub repository.

Releases

June 17, 2026

v5.2.0

Latest
June 17, 2026

⚠️ Breaking

  • organization_membership:
  • Changed response of UserManagementOrganizationMembership.list from UserOrganizationMembership to UserOrganizationMembershipList
  • pipes:
  • SDK surface change: Type changed for "DataIntegrationAccessTokenResponseAccessToken.ExpiresAt" from "string?" to "DateTimeOffset?"
  • user_management:
  • Changed response of UserManagementInvitations.list from UserInvite to UserInviteList
  • widgets:
  • SDK surface change: Symbol "WidgetSessionTokenResponse" was removed

Features

  • authorization:
  • Added model ReplaceGroupRoleAssignmentEntry
  • Added model ReplaceGroupRoleAssignments
  • Added model DeleteGroupRoleAssignmentsByCriteria
  • Added endpoint POST /authorization/groups/{group_id}/role_assignments
  • Added endpoint PUT /authorization/groups/{group_id}/role_assignments
  • Added endpoint DELETE /authorization/groups/{group_id}/role_assignments
  • Added endpoint GET /authorization/groups/{group_id}/role_assignments/{role_assignment_id}
  • Added endpoint DELETE /authorization/groups/{group_id}/role_assignments/{role_assignment_id}
  • client:
  • Added model ClientApiToken
  • Added model ClientApiTokenResponse
  • Added service Client
  • connect:
  • Added auth_method to ConnectedAccount
  • Added api_key_last_4 to ConnectedAccount
  • Added enum ConnectedAccountAuthMethod
  • groups:
  • Added model CreateGroupRoleAssignment
  • Added model GroupRoleAssignment
  • Added model GroupRoleAssignmentList
  • Added model GroupRoleAssignmentResource
  • organization_membership:
  • Added model UserOrganizationMembershipList
  • Added model UserOrganizationMembershipListListMetadata
  • pipes:
  • Added model DataIntegrationCredentials
  • Added model DataIntegrationConfigurationResponse
  • Added model DataIntegrationConfigurationListResponse
  • Added model ConfigureDataIntegrationBody
  • Added auth_methods to DataIntegrationsListResponseData
  • Added auth_method to DataIntegrationsListResponseDataConnectedAccount
  • Added api_key_last_4 to DataIntegrationsListResponseDataConnectedAccount
  • Added enum DataIntegrationCredentialsCredentialsType
  • Added enum DataIntegrationsListResponseDataAuthMethods
  • Added enum DataIntegrationsListResponseDataConnectedAccountAuthMethod
  • Added service PipesProvider
  • user_management:
  • Added model UserInviteList
  • Added model UserInviteListListMetadata
  • Made AuthorizationCodeSessionAuthenticateRequest.client_secret optional
  • Made RefreshTokenSessionAuthenticateRequest.client_secret optional
  • widgets:
  • Added widgets:pipes:manage to WidgetSessionTokenScopes
June 16, 2026

v5.1.0

June 16, 2026

Bug Fixes

Features

  • api_keys:
  • Added model ExpireApiKey
  • Added model ApiKeyUpdated
  • Added model ApiKeyUpdatedData
  • Added model ApiKeyUpdatedDataOwner
  • Added model UserApiKeyUpdatedDataOwner
  • Added model ApiKeyUpdatedDataPreviousAttribute
  • Added endpoint POST /api_keys/{id}/expire
  • audit_logs:
  • Added Snowflake to AuditLogConfigurationLogStreamType
  • connect:
  • Added name to UserObject
  • directory_sync:
  • Added model DsyncTokenCreated
  • Added model DsyncTokenCreatedData
  • Added model DsyncTokenRevoked
  • Added model DsyncTokenRevokedData
  • user_management:
  • Added name to user management models
  • webhooks:
  • Added api_key.updated to CreateWebhookEndpointEvents
  • Added api_key.updated to UpdateWebhookEndpointEvents
May 26, 2026

v5.0.0

May 26, 2026

v4.0.1...v5.0.0" rel="noreferrer" target="_blank">5.0.0 (2026-05-26)

⚠ BREAKING CHANGES

Features

Bug Fixes

May 11, 2026

v4.0.1

May 11, 2026

v4.0.0...v4.0.1" rel="noreferrer" target="_blank">4.0.1 (2026-05-11)

Bug Fixes

May 6, 2026

v4.0.0

May 6, 2026

v3.1.0...v4.0.0" rel="noreferrer" target="_blank">4.0.0 (2026-05-06)

⚠ BREAKING CHANGES

  • user_management: add user API key management and update models
  • api_keys: refactor API key models for organization and user ownership
  • authorization: replace RoleAssignment with UserRoleAssignment

Features

April 28, 2026

v3.1.0

April 28, 2026

v3.0.2...v3.1.0" rel="noreferrer" target="_blank">3.1.0 (2026-04-28)

Features

Bug Fixes

April 24, 2026

v3.0.2

April 24, 2026

v3.0.1...v3.0.2" rel="noreferrer" target="_blank">3.0.2 (2026-04-24)

Bug Fixes

April 21, 2026

v3.0.1

April 21, 2026

v3.0.0...v3.0.1" rel="noreferrer" target="_blank">3.0.1 (2026-04-21)

Bug Fixes

April 20, 2026

v3.0.0

April 20, 2026

v2.12.0...v3.0.0" rel="noreferrer" target="_blank">3.0.0 (2026-04-20)

⚠ BREAKING CHANGES

Features

Bug Fixes

March 30, 2026

v2.12.0

March 30, 2026

v2.11.0...v2.12.0" rel="noreferrer" target="_blank">2.12.0 (2026-03-30)

Features

March 5, 2026

v2.11.0

March 5, 2026

v2.10.1...v2.11.0" rel="noreferrer" target="_blank">2.11.0 (2026-03-05)

Features

Bug Fixes

December 3, 2025

v2.10.1

December 3, 2025

What's Changed

  • Version bump v2.10.1 by @kendallstrautman in #198
  • Multiple roles support: Add roles property to directory user and SSO profile by @kendallstrautman in #197

Full Changelog: v2.9.0...v2.10.1

December 2, 2025

v2.10.0

December 2, 2025

⚠️ Misconfigured release version. Use v2.10.1 instead

In this version, the package semver was not updated properly and still references v2.9.0

What's Changed

  • Multiple roles support: Add roles property to directory user and SSO profile by @kendallstrautman in #197

Full Changelog: v2.9.0...v2.10.0

April 25, 2025

v2.9.0

April 25, 2025

What's Changed

Full Changelog: v2.8.0...v2.9.0

March 28, 2025

v2.8.0

March 28, 2025

What's Changed

Full Changelog: v2.7.0...v2.8.0

February 24, 2025

v2.7.0

February 24, 2025

What's Changed

Added

Full Changelog: v2.6.0...v2.7.0

December 27, 2024

v2.6.0

December 27, 2024

Added

Full Changelog: v2.5.0...v2.6.0

October 21, 2024

v2.5.0

October 21, 2024

What's Changed

  • Add role to profile by @kendallstrautman in #179

Full Changelog: v2.4.0...v2.5.0

September 23, 2024

v2.4.0

September 23, 2024

What's Changed

  • Added custom exceptions for webhook verification by @gcsuk in #177

New Contributors

  • @gcsuk made their first contribution in #177

Full Changelog: v2.3.0...v2.4.0

July 18, 2024

v2.3.0

July 18, 2024

What's Changed

  • Add AppleOAuth constants by @gcarvelli in #167
  • Fix CI badge + add NuGet one by @gcarvelli in #172
  • v2.3.0 by @gcarvelli in #170
  • Added missing values to DirectoryState enum by @WillyPain in #174

New Contributors

  • @gcarvelli made their first contribution in #167
  • @WillyPain made their first contribution in #174

Full Changelog: v2.2.0...v2.3.0

June 26, 2024

v2.2.0

June 26, 2024

Deprecated

May 8, 2024

v2.1.0

May 8, 2024

What's Changed

December 14, 2023

v2.0.0

December 14, 2023

Added

  • Added ActorIds and ActorNames to CreateAuditLogExportOptions #127

Changed

  • [Breaking change] Renamed User to DirectoryUser (#132)
  • [Breaking change] Renamed ConnectionType to Type (#138)
  • [Breaking change] Changed directory states from linked/unlinked to active/inactive (#142)
  • [Breaking change] Changed default list pagination order to be DESC (#159)
  • [Breaking change] Changed Connection.Type to be a string and add ProviderType (#154)

Removed

  • [Breaking change] Removed Connection Status (#137)

Full Changelog: v1.17.4...v2.0.0

May 25, 2023

v1.17.4

May 25, 2023

Changed

March 29, 2023

v1.17.3

March 29, 2023

What's Changed

  • Fix user enums to include "Inactive"
March 27, 2023

v1.17.2

March 27, 2023

Changed

March 7, 2023

v1.17.0

March 7, 2023

Added

  • Added groups attribute to SSO user profile. This feature is in beta, please reach out to [support@workos.com](mailto:support@workos.com) to access this feature. (https://github.com/workos/workos-dotnet/pull/117" rel="noreferrer" target="_blank">#117)
December 6, 2022

v1.16.0

December 6, 2022

Added

December 2, 2022

v1.15.2

December 2, 2022

Changed

December 2, 2022

v1.15.1

December 2, 2022

Changed