Einladungen auflisten

GET /v1/invitations · Berechtigung invitations:read

Listet die Einladungen der Umgebung auf, die älteste zuerst. Es wird nur die Vorwärtspaginierung unterstützt. Filter: organization_id, email (exakte Übereinstimmung) und status. Der Cursor ist an die Filter gebunden; die E-Mail-Adresse fließt nur als geschützter Hash in den Cursor ein. Annahmelinks werden nie aufgelistet.

Anfrage

Feld Typ Pflicht Beschreibung
limit query nein 1–100, Standard 20.
after query nein Cursor aus list_metadata.after.
organization_id query nein Organisations-ID (org_…).
email query nein E-Mail-Adresse (exakte Übereinstimmung).
status query nein pending, accepted, revoked oder expired.

Kein Anfragetext.

Antwort

200 OK mit einer Seite von Einladungen.

{
  "data": [
    {
      "id": "inv_01j9xt9v3w4y8z0a2b4c6d8e0g",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "email": "ada@example.com",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ],
      "application_id": null,
      "delivery": "link_only",
      "delivery_status": "not_sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-10-12T09:31:00.123456Z",
      "expires_at": "2026-10-19T09:31:00.123456Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "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 anderen Filtern.
422 validation_failed Ein Filter oder limit ist ungültig, oder before bzw. eine order ungleich asc wurde angegeben.
401 unauthenticated Das Authentifizierungsmerkmal fehlt, ist ungültig oder wurde widerrufen.
403 insufficient_permissions Das Authentifizierungsmerkmal hat nicht 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 -i "https://api.eu.keenauth.com/v1/invitations?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=pending" \
  -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 die Daten aufbewahrt werden und wie sie gelöscht werden. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).