接続の rpId 移行を取得

GET /v1/connections/{connection_id}/rp-id-migration · 権限 connections:read

パスキー接続の最新の rpId 移行を返します。移行が実行中か、すでに終了しているかは問いません(パスキーの rpId を変更を参照してください)。件数は移行の終了時に記録され、移行が active の間は null になります。読み取り操作は監査されません。

リクエスト

フィールド 種類 必須 説明
connection_id パス はい パスキー接続 ID(conn_…)。

レスポンス

200 OK:

{
  "id": "rpm_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "connection_id": "conn_01j9xp6q0r1s5t7v9w1x3y5z7b",
  "previous_rp_id": null,
  "new_rp_id": "login.example.com",
  "status": "completed_early",
  "started_at": "2026-10-27T10:00:00Z",
  "ends_at": "2027-01-25T10:00:00Z",
  "completed_at": "2026-12-01T09:00:00Z",
  "revoked_count": 12,
  "new_registration_count": 340,
  "fallback_enabled_by_migration": false
}
フィールド 説明
status active(実行中)、completed(期間が終了)、または completed_early(期間前に終了)。
revoked_count 移行の終了時に取り消された、以前の rpId 上のパスキーの数。
new_registration_count 移行期間中に新しい rpId で登録されたパスキーの数。

エラー

HTTP code 発生条件
404 not_found 接続がこの環境に存在しない、パスキー接続ではない、または rpId 移行を一度も行っていません。
401 unauthenticated 認証情報が存在しないか、無効または取り消されています。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間を待ってから再試行してください。
503 service_unavailable 依存先が一時的に利用できません。Retry-After の期間を待ってから再試行してください。

例

curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/rp-id-migration" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
keenauth connections rp-id-migration conn_01j9xp6q0r1s5t7v9w1x3y5z7b