Listar mis identidades vinculadas

GET /fapi/v1/me/identities · llamado desde el host de inicio de sesión del entorno

Lista las identidades vinculadas a la cuenta del usuario autenticado (contraseña, social, SAML, OIDC, heredada), de la más antigua a la más reciente. El sujeto externo (sub de OIDC, NameID de SAML), la dirección de correo electrónico del proveedor de identidad y las referencias de credenciales nunca se devuelven. Las claves de acceso y los métodos de código de un solo uso son autenticadores y se listan en GET /fapi/v1/me/authenticators. La lectura no requiere una sesión verificada recientemente. Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación propia en otro origen puede enviar en su lugar su token de acceso a la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API frontal).

Solicitud

Encabezados:

Encabezado Obligatorio Descripción
Idp-Client sí Identificador del SDK.

Sin cuerpo.

Respuesta

200 OK con {"data": [...]}.

Cada elemento: id (idn_…), type (password, social, saml, oidc, legacy), connection_id (conn_…; null para password), provider (código del proveedor social, como google; null para otros tipos), linked_via (cómo se vinculó la identidad: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match), created_at.

Use el id con DELETE /fapi/v1/me/identities/{identity_id} para desvincular una identidad.

Errores

Estado Código Cuándo
401 unauthenticated No hay una cookie de sesión válida.

Ejemplo

curl https://example.keenauth.app/fapi/v1/me/identities \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
{
  "data": [
    {
      "id": "idn_01j9zzzzzzzzzzzzzzzzzzzzzz",
      "type": "social",
      "connection_id": "conn_01j9yyyyyyyyyyyyyyyyyyyyyy",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-10-01T09:00:00Z"
    }
  ]
}

Datos personales

Este endpoint contiene datos personales: identidades vinculadas. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.