Lister les connexions

GET /v1/connections · autorisation connections:read

Liste les connexions de l'environnement auquel appartient l'identifiant d'authentification, de la plus récente à la plus ancienne, par pages à curseur. L'environnement provient toujours de l'identifiant d'authentification ; les connexions d'autres environnements ne sont jamais renvoyées. Modifier type ou status invalide les curseurs émis pour un autre filtre (400 invalid_cursor).

Requête

Paramètres de requête :

Champ Type Obligatoire Description
limit integer non De 1 à 100, valeur par défaut 20.
after / before string non Curseurs opaques issus de list_metadata ; mutuellement exclusifs.
order string non asc ou desc (par défaut) selon la date de création.
type string non Filtre par type de connexion, par exemple social.
status string non Filtre par statut : active ou inactive.

Réponse

200 OK avec data (connexions) et list_metadata (before, after ; null lorsqu'il n'existe pas de page suivante dans cette direction). Aucun nombre total n'est renvoyé.

{
  "data": [{
      "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
      "key": "google",
      "type": "social",
      "strategy": "google",
      "name": "Google",
      "display_name": "Sign in with Google",
      "status": "inactive",
      "org_id": null,
      "allowed_email_domains": [],
      "allow_external_domains": false,
      "jit_mode": null,
      "email_trust": null,
      "default_role_ids": [],
      "trust_idp_mfa": null,
      "allow_idp_initiated": null,
      "idp_initiated_default_application_id": null,
      "idp_initiated_allowed_application_ids": [],
      "settings": {},
      "created_at": "2026-10-05T09:30:00.123456Z",
      "updated_at": "2026-10-05T09:30:00.123456Z"
    }],
  "list_metadata": { "before": null, "after": "<cursor>" }
}

Erreurs

HTTP code Quand
400 invalid_cursor Le curseur est mal formé ou a été émis pour un autre filtre.
422 validation_failed Un paramètre de requête est invalide.
401 unauthenticated L'identifiant d'authentification est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant d'authentification 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 période indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période indiquée par Retry-After.

Exemple

curl "https://api.eu.keenauth.com/v1/connections?type=social&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"