Obtenir un utilisateur d'annuaire

GET /v1/directories/{directory_id}/users/{directory_user_id} · autorisation directories:read

Renvoie un enregistrement utilisateur actif de l'annuaire, avec les mêmes champs que Lister les utilisateurs de l'annuaire. Sans l'autorisation users:read_pii, les données personnelles sont masquées de la même manière et attributes vaut null.

Requête

Champ Type Obligatoire Description
directory_id path oui Identifiant de l'annuaire SCIM (dir_…).
directory_user_id path oui Identifiant de l'utilisateur d'annuaire (dsu_…).

Il n'y a pas de corps de requête.

Réponse

200 OK avec l'utilisateur d'annuaire.

{
  "id": "dsu_01j9xp4q6r8s0t2v4w6x8y0z2b",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "external_id": "00u1a2b3c4",
  "user_name": "j***",
  "emails": [{ "value": "j***@e***.com", "primary": true }],
  "given_name": "J.",
  "family_name": "D.",
  "display_name": "J. D.",
  "locale": "en-US",
  "zoneinfo": "Europe/Berlin",
  "state": "inactive",
  "attributes": null,
  "groups": [],
  "user_id": null,
  "link_status": "unlinked",
  "drift": false,
  "created_at": "2026-10-20T09:00:00Z",
  "updated_at": "2026-10-20T09:05:00Z"
}

L'exemple montre une réponse à un identifiant sans users:read_pii.

Erreurs

HTTP code Quand
404 not_found L'annuaire ou l'enregistrement utilisateur n'existe pas dans cet environnement, appartient à un autre annuaire ou a été supprimé.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période indiquée par Retry-After.
503 service_unavailable La synchronisation de l'annuaire est temporairement indisponible ou non configurée dans ce déploiement ; réessayez après la période indiquée par Retry-After.

Exemple

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/users/dsu_01j9xp4q6r8s0t2v4w6x8y0z2b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Données personnelles

Cet endpoint traite des données personnelles : des utilisateurs d'annuaire (SCIM). Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. Ne transmettez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.