Verzeichnisbenutzer abrufen

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

Gibt einen aktiven Benutzerdatensatz des Verzeichnisses zurück, mit denselben Feldern wie Verzeichnisbenutzer auflisten. Ohne die Berechtigung users:read_pii werden die personenbezogenen Daten auf die gleiche Weise maskiert, und attributes ist null.

Anfrage

Feld Typ Pflichtfeld Beschreibung
directory_id path ja SCIM-Verzeichniskennung (dir_…).
directory_user_id path ja Kennung des Verzeichnisbenutzers (dsu_…).

Es gibt keinen Anfragetext.

Antwort

200 OK mit dem Verzeichnisbenutzer.

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

Das Beispiel zeigt eine Antwort auf Anmeldedaten ohne users:read_pii.

Fehler

HTTP Code Wann
404 not_found Das Verzeichnis oder der Benutzerdatensatz existiert in dieser Umgebung nicht, gehört zu einem anderen Verzeichnis oder wurde gelöscht.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder widerrufen.
403 insufficient_permissions Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.
503 service_unavailable Die Verzeichnissynchronisierung ist vorübergehend nicht verfügbar oder in dieser Bereitstellung nicht konfiguriert; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.

Beispiel

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

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Verzeichnisbenutzer (SCIM). Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).