Einladungen einer Organisation auflisten

GET /fapi/v1/organizations/{org_id}/invitations · wird vom Anmeldehost der Umgebung aufgerufen

Listet die Einladungen einer Organisation in der Reihenfolge ihrer Erstellung auf, zum Beispiel für eine Profilansicht der Organisation. Eine ausstehende Einladung zeigt die eingeladene Adresse nur an, wenn Sie zusätzlich idp_members:read besitzen; andernfalls ist email gleich null. Angenommene, widerrufene und abgelaufene Einladungen enthalten nie eine Adresse.

Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers oder ein Zugriffstoken der Front API einer Anwendung der ersten Partei (Authorization: DPoP <token> mit einem DPoP-Nachweis; siehe Zugriffstoken der Front API). Der Benutzer muss aktives Mitglied der Organisation sein und die Berechtigung idp_members:invite besitzen. Ein Benutzer, der kein Mitglied ist, erhält 404 not_found; ein Mitglied ohne die Berechtigung erhält 403 insufficient_permissions.

Mit @keenauth/js: await keenauth.organizations.invitations(orgId, { status: "pending" }).

Anfrage

Header:

Header Erforderlich Beschreibung
Idp-Client ja Kennung des SDK.

org_id: die Kennung der Organisation (org_…).

Abfrageparameter:

Parameter Erforderlich Beschreibung
status nein pending, accepted, revoked oder expired; ohne Angabe alle vier.
after nein Der Wert next_after der vorherigen Seite.
limit nein 1–100, Standardwert 20.

Kein Body.

Antwort

200 OK mit {"data": [...], "next_after": "..."}; next_after fehlt auf der letzten Seite. Jeder Eintrag hat die Felder von einer Einladung.

Fehler

Status Code Wann
400 invalid_cursor after ist fehlerhaft formatiert.
401 unauthenticated Kein gültiges Sitzungs-Cookie oder Token.
403 insufficient_permissions Der Benutzer besitzt idp_members:invite in der Organisation nicht.
404 not_found Keine solche Organisation für diesen Benutzer; eine unbekannte, fehlerhafte oder fremde Kennung führt zu derselben Antwort.
422 validation_failed status oder limit ist ungültig.
503 service_unavailable Vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After.

Beispiel

curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations?status=pending&limit=1" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
      "email": "new.member@example.com",
      "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
      "delivery": "email",
      "delivery_status": "sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-11-03T10:00:00Z",
      "expires_at": "2026-11-10T10:00:00Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-11-03T10:00:00Z",
      "updated_at": "2026-11-03T10:00:00Z",
      "version": 1
    }
  ],
  "next_after": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d"
}

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Mitgliedschaften in Organisationen 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).