# 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](/docs/api/fapi/front-api-token)). 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](/docs/api/fapi/organizations/invitations/create) 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

```bash
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
```

```json
{
  "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](/docs/policies/personal-data) 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).