Obtener un usuario de directorio

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

Devuelve un registro activo de usuario del directorio, con los mismos campos que Listar usuarios del directorio. Sin el permiso users:read_pii, los datos personales se enmascaran de la misma forma y attributes es null.

Solicitud

Campo Tipo Obligatorio Descripción
directory_id path sí Identificador del directorio SCIM (dir_…).
directory_user_id path sí Identificador del usuario del directorio (dsu_…).

No hay cuerpo de solicitud.

Respuesta

200 OK con el usuario del directorio.

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

El ejemplo muestra una respuesta para una credencial sin users:read_pii.

Errores

HTTP code Cuándo
404 not_found El directorio o el registro del usuario no existe en este entorno, pertenece a otro directorio o ha sido eliminado.
401 unauthenticated La credencial falta, no es válida o ha sido revocada.
403 insufficient_permissions La credencial no tiene el permiso necesario.
429 rate_limited Se ha superado el límite de uso; reintente después del periodo indicado en Retry-After.
503 service_unavailable La sincronización de directorios no está disponible temporalmente o no está configurada en este despliegue; reintente después del periodo indicado en Retry-After.

Ejemplo

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

Datos personales

Este endpoint trata datos personales: usuarios de directorios (SCIM). Datos personales en las API de KeenAuth describe qué se almacena, cuánto tiempo se conserva y cómo se eliminan. 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.