Elenco delle identità collegate di un utente

GET /v1/users/{user_id}/identities · autorizzazione users:read

Elenca in un'unica pagina le identità collegate di un utente (password, social, SAML, OIDC e legacy), in ordine di creazione. Il numero di identità per utente è limitato, quindi l'elenco non ha limit, after, before o order, e list_metadata ha sempre valore null. Il soggetto esterno di un'identità (sub di OIDC, NameID di SAML), l'indirizzo email comunicato dal provider di identità e il riferimento alle credenziali non vengono mai restituiti. Le passkey e i metodi con codice monouso sono autenticatori e vengono elencati da GET /v1/users/{user_id}/authenticators.

Richiesta

Parametro In Obbligatorio Descrizione
user_id path sì ID utente, con prefisso usr_.

Risposta

200 OK. data contiene le identità ordinate per data di creazione; list_metadata ha sempre valore null perché l'elenco non è paginato. connection_id è null per password; provider è valorizzato solo per social.

Gli ID delle identità hanno il prefisso idn_.

{
  "data": [
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2q",
      "type": "password",
      "connection_id": null,
      "provider": null,
      "linked_via": "primary",
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2r",
      "type": "social",
      "connection_id": "conn_0a1b2c3d4e5f6g7h8j9k0m1n2s",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

type: password, social, saml, oidc, legacy · linked_via: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match

Errori

Ogni errore è un corpo application/problem+json con un code stabile.

HTTP code Quando
404 not_found L'utente non esiste in questo ambiente (o l'ID è malformato).
401 unauthenticated La chiave API manca, non è valida o è stata revocata.
403 insufficient_permissions La chiave non ha l'autorizzazione users:read.
429 rate_limited È stato superato il limite di richieste; rispetta Retry-After.
503 service_unavailable Una dipendenza non è temporaneamente disponibile; riprova più tardi.

Esempio

curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Dati personali

Questo endpoint contiene 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.