Skip to main content
GET
List SSO connections
Returns the SAML or OIDC connection configured for your organization. Related guide: User provisioning: SSO and SCIM.
Availability: Cloud · Enterprise (self-hosted). Not available on the Community edition: a self-hosted deployment needs ENTERPRISE_ENABLED=true, otherwise the endpoint answers 403 with error.type: "enterprise_license_required".

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Response

Connections (credentials redacted)

id
string
type
enum<string>
Available options:
saml,
oidc
status
string

pending until the first successful sign-in, then active; disabled when turned off.

displayName
string
cognitoProviderName
string

The identity-provider name the login page sends users to.

config
object | null
createdAt
string<date-time>
updatedAt
string<date-time>