Skip to content
Dashboard
Theme
Theme

Set the sign-in risk policy

PUT /v1/sign_in_risk_policy: Set the sign-in risk policy.

View Markdown

PUT /v1/sign_in_risk_policy

Creates or replaces the environments risk policy (Business and Enterprise; plan_limit_reached below). When a sign-ins risk score reaches min_score (and, with reasons, one of them fired), deny refuses it with sign_in_risk_denied and step_up asks the pre_profile_issue hook with the risk included (refused when there is no hook). allow only records the risk on the profile and the timeline.

Scope
policies:write
Auth
Secret key (sk_…)
Since
1.0
  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

  • min_score integer Required

    min 1 · max 100

  • action string Required

    one of allow, step_up, deny

  • reasons array of string

    max items 4

Errors share one shape; see the error code catalogue.

curl -X PUT \
"https://api.ohauthcat.com/v1/sign_in_risk_policy" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"min_score": 1,
"action": "allow"
}'
Response 200
{
"object": "sign_in_risk_policy",
"min_score": 1,
"action": "allow",
"reasons": [
"impossible_travel"
],
"updated_at": "2026-01-15T09:30:00Z"
}