ディレクトリユーザーを取得

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

ディレクトリ内の有効なユーザーレコードを 1 件返します。フィールドはディレクトリユーザーの一覧取得と同じです。users:read_pii 権限がない場合、個人データは同様にマスクされ、attributes は null になります。

リクエスト

フィールド	型	必須	説明
`directory_id`	path	はい	SCIM ディレクトリの ID（`dir_…`）。
`directory_user_id`	path	はい	ディレクトリユーザーの ID（`dsu_…`）。

リクエストボディはありません。

レスポンス

ディレクトリユーザーを含む 200 OK。

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

この例は、users:read_pii のない認証情報に対するレスポンスを示しています。

エラー

HTTP	code	発生条件
404	`not_found`	ディレクトリまたはユーザーレコードがこの環境に存在しないか、別のディレクトリに属しているか、削除されています。
401	`unauthenticated`	認証情報がないか、無効または取り消されています。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` の期間を過ぎてから再試行してください。
503	`service_unavailable`	ディレクトリの同期が一時的に利用できないか、このデプロイメントで構成されていません。`Retry-After` の期間を過ぎてから再試行してください。

例

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

個人データ

このエンドポイントは個人データ（ディレクトリ（SCIM）のユーザー）を扱います。KeenAuth API の個人データでは、保存される内容、保持期間、削除方法について説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。