Obtenir la migration du rpId d'une connexion

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

Renvoie la dernière migration de rpId d'une connexion par clé d'accès, qu'elle soit toujours en cours ou déjà clôturée (voir Modifier le rpId des clés d'accès). Les compteurs sont écrits à la clôture de la migration et valent null tant qu'elle est active. Les lectures ne sont pas auditées.

Requête

Champ	Type	Obligatoire	Description
`connection_id`	chemin	oui	ID de la connexion par clé d'accès (`conn_…`).

Réponse

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
}

Champ	Description
`status`	`active`, `completed` (la fenêtre s'est terminée) ou `completed_early`.
`revoked_count`	Clés d'accès sur l'ancien rpId révoquées à la clôture de la migration.
`new_registration_count`	Clés d'accès enregistrées sur le nouveau rpId pendant la fenêtre.

Erreurs

HTTP	code	Cas
404	`not_found`	La connexion n'existe pas dans cet environnement, n'est pas une connexion par clé d'accès ou n'a jamais eu de migration de rpId.
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 durée indiquée par `Retry-After`.
503	`service_unavailable`	Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par `Retry-After`.

Exemple

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