Set the account-default risk dial (console plane, human authority)

PATCH

/v1/admin/orgs/{org_id}/projects/{project_id}/risk-dial

• Production
• Local

Set the account-wide risk-dial defaults every inheriting category uses (D4): min_confidence, first_contact_gate, drift_demote_after (K), canary_rate, graduate_min_approvals, graduate_min_age_hours, auto_send_cap_per_day. A nil field is unchanged. Console-only (never an MCP tool, D17).

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

Request Body ^required

Set the account-default risk dial (console plane, D4). A nil field leaves that column unchanged.

object

min_confidence

number format: double

first_contact_gate

boolean

drift_demote_after

integer

canary_rate

number format: double

graduate_min_approvals

integer

graduate_min_age_hours

integer

auto_send_cap_per_day

integer

Responses

200

Ok

The account-wide default risk dial (org_settings; D4/D12); the values a per-category null override inherits. The single user-configurable brand-risk lever (canary rate, drift-demote K, maturity-gate thresholds, min confidence, first-contact gate, per-day auto-send cap).

object

min_confidence

required

number format: double

first_contact_gate

required

boolean

drift_demote_after

required

Drift-demote threshold K.

integer

canary_rate

required

number format: double

graduate_min_approvals

required

Maturity-gate N (clean approvals).

integer

graduate_min_age_hours

required

Maturity-gate minimum category age.

integer

auto_send_cap_per_day

required

Plan-tier per-customer auto-send volume cap (D1).

integer

400

Invalid request.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

403

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope