v4

latestOpenAPI 3.0.32026-07-312,317012.2 MB
OIDC SSO

Create OIDC config

post/api/v1/sso/oidc/config

Request body

allowedEmailDomainsstring

A list of allowed email domains that users can use to authenticate with. This field is comma separated. Supports wildcards (e.g. *.example.com).

configurationType'custom' | 'discoveryURL' required

The configuration type to use for the OIDC configuration.

issuerstring

The issuer for the OIDC configuration. This is only supported when the OIDC configuration type is set to 'custom'.

discoveryURLstring

The URL of the OIDC discovery endpoint.

authorizationEndpointstring

The authorization endpoint to use for OIDC authorization. This is only supported when the OIDC configuration type is set to 'custom'.

jwksUristring

The URL of the OIDC JWKS endpoint.

tokenEndpointstring

The token endpoint to use for OIDC token exchange.

userinfoEndpointstring

The userinfo endpoint to get user information from the OIDC provider.

clientIdstring required

The client ID to use for OIDC authentication.

clientSecretstring required

The client secret to use for OIDC authentication.

isActiveboolean required

Whether to enable or disable this OIDC configuration.

organizationIdstring required

The ID of the organization to create the OIDC config for.

manageGroupMembershipsboolean

Whether to manage group memberships for the OIDC configuration. If enabled, users will automatically be assigned groups when they sign in, based on which groups they are a member of in the OIDC provider.

jwtSignatureAlgorithm'RS256' | 'HS256' | 'RS512' | 'EdDSA'

The algorithm to use for JWT signature verification.

Response

Default Response

idstring uuid required
issuerstring nullable
authorizationEndpointstring nullable
configurationTypestring required
discoveryURLstring nullable
jwksUristring nullable
tokenEndpointstring nullable
userinfoEndpointstring nullable
orgIdstring uuid required
isActiveboolean required
allowedEmailDomainsstring nullable
manageGroupMembershipsboolean
jwtSignatureAlgorithmstring