Elenca le mie identità collegate

GET /fapi/v1/me/identities · chiamato dall'host di accesso dell'ambiente

Elenca le identità collegate all'account dell'utente autenticato (password, social, SAML, OIDC, legacy), dalla più vecchia alla più recente. Il soggetto esterno (sub OIDC, NameID SAML), l'indirizzo email dell'provider di identità e i riferimenti alle credenziali non vengono mai restituiti. Passkey e metodi con codice monouso sono autenticatori e sono elencati in GET /fapi/v1/me/authenticators. La lettura non richiede una sessione verificata di recente. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o revocato, restituisce 401 unauthenticated. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso alla Front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso alla Front API).

Richiesta

Intestazioni:

Intestazione Obbligatoria Descrizione
Idp-Client sì Identificatore dell'SDK.

Nessun corpo.

Risposta

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

Ogni elemento: id (idn_…), type (password, social, saml, oidc, legacy), connection_id (conn_…; null per password), provider (codice del provider social come google; null per gli altri tipi), linked_via (come è stata collegata l'identità: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match), created_at.

Usa id con DELETE /fapi/v1/me/identities/{identity_id} per scollegare un'identità.

Errori

Stato Codice Quando
401 unauthenticated Nessun cookie di sessione valido.

Esempio

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"
    }
  ]
}

Dati personali

Questo endpoint tratta dati personali: identità collegate. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.