latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

Recovery Policy

Create

Create a recovery policy.

post/api/v1/recovery-policies

Request body

allowedRecoveryTypesstring[] nullable

The credential types a user may use to recover access.

displayNamestring required

A human-readable name for the policy.

minRecoveryAuthLevel'AUTH_LEVEL_UNSPECIFIED' | 'AUTH_LEVEL_NONE' | 'AUTH_LEVEL_SINGLE_FACTOR' | 'AUTH_LEVEL_MULTI_FACTOR' | 'AUTH_LEVEL_PHR' | 'AUTH_LEVEL_PHRH'

The minimum assurance level a recovery ceremony must reach.

priorityinteger

When a user matches more than one policy, the policy with the highest priority applies.

revokeOnRecoveryboolean

When true, a successful recovery revokes existing credentials and forces re-enrollment.

Response

Successful response