Eine Einladung abrufen

GET /v1/invitations/{invitation_id} · Berechtigung invitations:read

Gibt die Einladung ohne ihren Annahmelink zurück. Die E-Mail-Adresse einer widerrufenen oder abgelaufenen Einladung ist null.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`invitation_id`	path	ja	Einladungs-ID (`inv_…`).

Kein Anfragetext.

Antwort

200 OK mit der Einladung.

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

Fehler

HTTP	Code	Wann
404	`not_found`	Die Einladung existiert in dieser Umgebung nicht.
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/inv_01j9xt9v3w4y8z0a2b4c6d8e0g" \
  -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).