Replace an OTP card with a newly generated card
POST/nevisidm/api/core/v1/:clientExtId/users/:userExtId/otp-credentials/:extId/replace
Since: 8.2605.0, 9.2605.0
Required permission(s): AccessControl.CredentialModify,AccessControl.CredentialView
Replaces the OTP card credential identified by its external ID with a freshly generated OTP card.
The credential's external ID, policy, and state are preserved. Only the OTP card data itself (the grid of one-time passwords) is regenerated. This is typically used when a user loses their OTP card and needs a new one.
In self-admin mode, the user can replace their own OTP card. A valid JWT token must be provided in the X-Token request header for self-admin operations.
Request
Responses
- 200
- 403
- 404
- 409
OTP card replaced successfully
Insufficient permissions
Referenced resource not found
Optimistic locking conflict