Actualizar el método de autenticación

Actualiza un único método de autenticación

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

Actualizar los detalles de un método de autenticación por ID

cURL

curl --request PATCH \
  --url https://{host}/me/v1/authentication-methods/{authentication_method_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

200

{
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "usage": [],
  "identity_user_id": "<string>",
  "type": "password",
  "last_password_reset": "2023-11-07T05:31:56Z"
}

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

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

name · string

El nombre descriptivo del método de autenticación

preferred_authentication_method · enum<string>

El método de autenticación preferido (para autenticadores de teléfono)

Opciones disponibles: sms, voice

Respuesta

200

application/json

Método de autenticación actualizado correctamente

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