Confirmar el método de autenticación

Confirma la inscripción de un método de autenticación compatible.

POST https://{host}/me/v1/authentication-methods/{authentication_method_id}/verify

cURL

email

curl --request POST \
  --url https://{host}/me/v1/authentication-methods/{authentication_method_id}/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "auth_session": "Fe26.2**05c400ed...",
  "otp_code": "123456"
}
'

201

email

{
  "confirmed": true,
  "created_at": "2025-01-15T10:30:00.000Z",
  "email": "[e-mail]",
  "id": "email|dev_XXXXXXXXXXXXXXXX",
  "type": "email",
  "usage": [
    "secondary"
  ]
}

Autorizaciones

Authorization · string · header · requerido

Los tokens Bearer y DPoP son compatibles según la configuración de la API

Parámetros de ruta

authentication_method_id · string · requerido

ID del método de autenticación. Este valor forma parte del encabezado Location que se devuelve al crear un método de autenticación. Debe usarse tal como está, sin ninguna modificación.

Cuerpo

application/json

Passkey verification payload

Password verification payload

WebAuthn Platform verification payload

WebAuthn Roaming verification payload

Push Notification verification payload

Recovery Code verification payload

Email verification payload

Phone verification payload

TOTP verification payload

Contenido de la solicitud para verificar un método de autenticación

auth_session · string · requerido

El identificador único de la sesión de inscripción, tal como lo devuelve POST /authentication-methods

authn_response · object · requerido

Show child attributes

Respuesta

201

application/json

Método de autenticación verificado

password

passkey

recovery-code

push-notification

totp

webauthn-platform

webauthn-roaming

phone

email

created_at · string<date-time> · requerido

La fecha y hora en que se creó el método de autenticación

id · string · requerido

El identificador único del método de autenticación

usage · enum<string>[] · requerido

Factor principal y/o secundario

Tipo de uso de los factores de autenticación

Opciones disponibles: primary, secondary

identity_user_id · string · requerido

El ID de la identidad de usuario vinculada al método de autenticación

type · string · predeterminado: password · requerido

Tipo de método de autenticación (factor)

Allowed value: "password"

last_password_reset · string<date-time>

La fecha del último restablecimiento de contraseña