Create or replace the organization's identity provider
Requires organization:update. Kapten fetches the issuer’s discovery document first, and refuses (400) one it cannot fetch or whose issuer differs. New domains start unverified; domains kept keep their verification. Changing the issuer ends the sessions the former provider started. The provisioning Role must exist and must not grant organization:delete.
/organizations/{organizationId}/ssoAuthorizationBearer token (JWT) · headerrequiredAn access token issued by this service (RFC 9068), in the Authorization header as Bearer <token>.
organizationIdstring<uuid>requiredapplication/jsonissuerstringrequiredAn https URL (plain http only when auth itself runs on http, in development).
client_idstringrequiredclient_secretstringRequired to create a connection; omit it to keep the current secret. Stored encrypted and never returned.
domainsstring[]requiredenforcedbooleanrequiredprovisioning_rolestringName of a Role to give on first SSO login; omit or leave empty to turn just-in-time provisioning off.
The saved connection.
issuerstringrequiredThe provider's issuer identifier; auth reads {issuer}/.well-known/openid-configuration.
client_idstringrequiredredirect_uristringrequiredThe redirect URI to register at the provider, the same for every organization.
domainssso_domain[]requiredThe organization's email domains, sorted. Once verified, a domain is routed to the provider (home realm discovery), and only verified addresses on verified domains may sign in through it.
Show propertiesHide properties
sso_domaindomainstringrequiredrecord_namestringrequiredName of the TXT record to publish, _kapten-sso.<domain>.
record_valuestringrequiredValue of the TXT record.
verified_atstring<date-time>When the record was found; absent while the domain is unverified and not routed.
enforcedbooleanrequiredMembers must sign in through the provider to get tokens for the organization; owners are exempt so a broken provider never locks the organization out.
provisioning_rolestringRole given to people on their first SSO login (just-in-time provisioning); absent when it is off and only invited people or members can sign in.
created_atstring<date-time>requiredupdated_atstring<date-time>requiredThe request failed.
errorstringrequiredStable machine-readable code.
invalid_requestunauthorizedforbiddennot_foundconflictgoneunavailableinternalmessagestringrequiredHuman-readable explanation.