Mitgliedschaften einer Organisation auflisten

GET /v1/organizations/{org_id}/memberships · Berechtigung organizations:read

Listet die Mitgliedschaften der Organisation nach letzter Aktualisierung auf, älteste zuerst (bei Gleichstand nach ID). Es wird nur Vorwärtspaginierung unterstützt. Filter: status, role_id, updated_after. Der Cursor ist an die Organisation und die Filter gebunden.

Anfrage

Feld Typ Pflicht Beschreibung
org_id path ja Organisations-ID (org_…).
limit query nein 1–100, Standardwert 20.
after query nein Cursor aus list_metadata.after.
status query nein invited, active, suspended oder removed.
role_id query nein Nur Mitgliedschaften, die diese Rolle haben (rol_…).
updated_after query nein RFC-3339-Zeitpunkt; nur Mitgliedschaften, die danach aktualisiert wurden.

Kein Anfragekörper.

Antwort

200 OK mit einer Seite von Mitgliedschaften.

{
  "data": [
    {
      "id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "user_id": "usr_01j9xh2k6p7q1r3s5t7v9w1x3y",
      "status": "active",
      "source": "admin_api",
      "reason": null,
      "roles": [
        {
          "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
          "source": "admin_api",
          "assigned_at": "2026-10-12T09:31:00.123456Z"
        }
      ],
      "expires_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "activated_at": "2026-10-12T09:31:00.123456Z",
      "suspended_at": null,
      "removed_at": null,
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Fehler

HTTP code Wann
400 invalid_cursor Der Cursor ist ungültig oder gehört zu einer anderen Organisation oder einem anderen Filter.
404 not_found Die Organisation existiert in dieser Umgebung nicht.
422 validation_failed Ein Filter oder limit ist ungültig, oder before bzw. ein order ungleich asc wurde angegeben.
401 unauthenticated Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Berechtigungsnachweis hat nicht die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.

Beispiel

curl -i "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).