Skip to content
Dashboard
Theme
Theme

Set an organization's end-user auth overrides

PUT /v1/organizations/{org}/user_management_settings: Set an organization's end-user auth overrides.

View Markdown

Business and above.

PUT /v1/organizations/{org}/user_management_settings

Scope
users:write
Auth
Secret key (sk_…)
Since
1.0
  • org string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

  • mfa_required boolean Required

  • methods array of string or null

  • sso_required boolean

    End users whose email is on one of the organization’s verified domains must sign in with SSO. The hosted login routes them to the organization’s SSO when it can (an active, tested connection and a flow started by an app) and otherwise refuses with end_user_sso_required; password, magic-code, passkey and social first factors (hosted and headless) are refused with end_user_sso_required for them. Domains without the policy answer exactly as before, so the identify step reveals nothing about a domain that does not route to SSO. Default false; omitted on update keeps false.

Errors share one shape; see the error code catalogue.

curl -X PUT \
"https://api.ohauthcat.com/v1/organizations/org_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/user_management_settings" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mfa_required": true
}'
Response 200
{
"mfa_required": true,
"methods": [
"password"
],
"sso_required": true
}