Reset Second Step
Reset a user's second step, for a user who lost their phone or passkey: their passkeys, authenticator app and recovery codes are removed and they are signed out everywhere. They set one up again at their next sign-in, after a code emailed to them or a setup link. A user with a confirmed email is told. Make sure it's really that user asking. In the dashboard: Reset on the user's page.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.client_uuid string (uuid) Req
The user's
uuid from List Users. Resolved under this endpoint only.An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Request body
None.
Response (200 OK)
endpoint_uuid, client_uuid string (uuid)
The endpoint and the user.
reset boolean
true.Errors
401 Unauthorized
Missing auth.
403 Forbidden
Caller lacks the
endpoints:delete permission, or the account's plan doesn't include users and roles.404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account, or the user doesn't belong to this endpoint (
endpoint user not found).409 Conflict
Nothing to reset: this user has no second step.503 Service Unavailable
The second step isn't available yet.Request
curl -X DELETE \
"https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/clients/019b4b9d-d300-736b-8601-153b3d9f70ee/second-step" \
-H "X-API-KEY: <your_api_key>"
Response
{
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee",
"reset": true
}
Was this helpful?