Einladung erneut senden

POST /v1/invitations/{invitation_id}:resend · Berechtigung invitations:write

Sendet eine ausstehende Einladung mit einem neuen Token erneut: Der bisherige Link funktioniert danach nicht mehr. Bei einer email-Einladung wird der neue Link nur per E-Mail versendet, und die Antwort enthält kein accept_url. Bei einer link_only-Einladung wird der Annahme-Link (accept_url) nur in dieser Antwort und genau einmal zurückgegeben; kein Endpunkt liefert ihn später erneut. Die Antwort enthält Cache-Control: no-store. Eine für denselben Idempotency-Key wiederholte Antwort lässt den Link weg und enthält secret_redacted: true. Erneute Sendungen müssen mindestens 10 Minuten auseinanderliegen und insgesamt höchstens 5 Sendungen umfassen; expires_at ändert sich dabei nicht. Der Schreibvorgang wird als invitation.resent protokolliert.

Anfrage

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

Kein Anfragekörper.

Antwort

200 OK mit der Einladung und ihrem neuen Annahme-Link.

{
  "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": 2,
  "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,
  "accept_url": "https://acme.eu.keenauth.app/u/login?invitation=<token>"
}

Fehler

HTTP code Wann
404 not_found Die Einladung existiert in dieser Umgebung nicht.
409 conflict Die Einladung ist nicht ausstehend.
429 invite_rate_limited Seit der letzten Sendung sind weniger als 10 Minuten vergangen, oder es wurden bereits 5 Sendungen versendet.
501 not_implemented Die Einladung verwendet die email-Zustellung, und der E-Mail-Versand für Einladungen ist für die Bereitstellung nicht konfiguriert.
401 unauthenticated Die Anmeldedaten fehlen, sind ungültig oder widerrufen.
403 insufficient_permissions Den Anmeldedaten fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach Ablauf des Retry-After-Zeitraums.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Ablauf des Retry-After-Zeitraums.

Beispiel

curl -i -X POST "https://api.eu.keenauth.com/v1/invitations/inv_01j9xt9v3w4y8z0a2b4c6d8e0g:resend" \
  -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 es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).