Einladung erneut senden
POST /fapi/v1/organizations/{org_id}/invitations/{invitation_id}:resend · wird vom Anmeldehost der Umgebung aufgerufen
Sendet eine ausstehende E-Mail-Einladung erneut mit einem neuen Link; der bisherige Link funktioniert danach nicht mehr. Das Ablaufdatum ändert sich nicht. Eine Einladung kann höchstens fünfmal gesendet werden, jeweils mit mindestens zehn Minuten Abstand; ein zu früher oder ein zusätzlicher Versand liefert 429 invite_rate_limited mit Retry-After. Eine Einladung, die nicht mehr ausstehend ist, oder eine Einladung, die ohne E-Mail-Zustellung erstellt wurde, liefert 422 invitation_invalid. Der Link selbst wird nie zurückgegeben.
Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers mit einem exakten Origin, 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. Nur ein Mitglied mit der Administratorrolle kann eine Einladung mit einer privilegierten Rolle erneut senden (403 role_not_assignable).
Mit @keenauth/js: await keenauth.organizations.resendInvitation(orgId, invitationId).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | Kennung des SDK. |
Origin |
ja, bei Verwendung des Cookies | https://<Anmeldehost>. |
org_id: die Kennung der Organisation (org_…). invitation_id: die Kennung der Einladung (inv_…).
Kein Body.
Antwort
200 OK mit der Einladung und ETag: "<version>"; send_count und last_sent_at spiegeln diesen Versand wider.
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie oder Token. |
| 403 | insufficient_permissions |
Der Benutzer besitzt idp_members:invite in der Organisation nicht. |
| 403 | role_not_assignable |
Die Einladung enthält eine privilegierte Rolle und der Benutzer hat die Administratorrolle nicht. |
| 403 | origin_not_allowed |
Der Origin stimmt nicht überein. |
| 404 | not_found |
Keine solche Organisation oder Einladung für diesen Benutzer; eine unbekannte, fehlerhafte oder fremde Kennung führt zu derselben Antwort. |
| 409 | organization_disabled |
Die Organisation ist deaktiviert oder zur Löschung vorgemerkt (organization_pending_deletion). |
| 422 | invitation_invalid |
Die Einladung ist nicht mehr ausstehend oder wurde nicht für die E-Mail-Zustellung erstellt. |
| 429 | invite_rate_limited |
Bereits fünfmal gesendet oder seit dem letzten Versand weniger als zehn Minuten vergangen; wiederholen Sie die Anfrage nach Retry-After. |
| 501 | not_implemented |
E-Mail-Zustellung ist in dieser Bereitstellung nicht verfügbar. |
| 503 | service_unavailable |
Vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After. |
Beispiel
curl -X POST "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations/inv_01jbz6x8kq3m2n4p5r6s7t8v9d:resend" \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
{
"id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
"email": "new.member@example.com",
"role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
"delivery": "email",
"delivery_status": "queued",
"status": "pending",
"send_count": 2,
"last_sent_at": "2026-11-03T10:30: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:30:00Z",
"version": 2
}
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).