Verbindungen auflisten

GET /v1/connections · Berechtigung connections:read

Listet die Verbindungen der Umgebung auf, zu der die Anmeldedaten gehören, neueste zuerst, in Cursor-Seiten. Die Umgebung stammt immer aus den Anmeldedaten; Verbindungen anderer Umgebungen werden nie zurückgegeben. Wenn Sie type oder status ändern, werden Cursor ungültig, die für einen anderen Filter ausgegeben wurden (400 invalid_cursor).

Anfrage

Abfrageparameter:

Feld Typ Pflicht Beschreibung
limit integer nein 1-100, Standard 20.
after / before string nein Undurchsichtige Cursor aus list_metadata; sie schließen sich gegenseitig aus.
order string nein asc oder desc (Standard) nach Erstellungszeit.
type string nein Filtern nach Verbindungstyp, zum Beispiel social.
status string nein Filtern nach Status: active oder inactive.

Antwort

200 OK mit data (Verbindungen) und list_metadata (before, after; null, wenn in dieser Richtung keine weitere Seite existiert). Eine Gesamtanzahl wird nicht zurückgegeben.

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

Fehler

HTTP code Wann
400 invalid_cursor Der Cursor ist fehlerhaft oder wurde für einen anderen Filter ausgegeben.
422 validation_failed Ein Abfrageparameter ist ungültig.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach dem Zeitraum aus Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach dem Zeitraum aus Retry-After.

Beispiel

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