Resend an invitation

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

Resends a pending invitation with a new token: the previous link stops working. For an email invitation the new link goes only by e-mail and the response has no accept_url. For a link_only invitation the accept link (accept_url) is returned only in this response, once; no endpoint returns it later. The response carries Cache-Control: no-store, and a response replayed for the same Idempotency-Key omits the link and carries secret_redacted: true. Resends need at least 10 minutes between them and at most 5 sends in total; expires_at does not move. The write is audited as invitation.resent.

Request

Field Type Required Description
invitation_id path yes Invitation ID (inv_…).

No request body.

Response

200 OK with the invitation and its new accept 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>"
}

Errors

HTTP code When
404 not_found The invitation does not exist in this environment.
409 conflict The invitation is not pending.
429 invite_rate_limited Less than 10 minutes since the last send, or 5 sends already.
501 not_implemented The invitation uses email delivery and invitation e-mail is not configured for the deployment.
401 unauthenticated The credential is missing, invalid or revoked.
403 insufficient_permissions The credential lacks the required permission.
429 rate_limited The rate limit was exceeded; retry after the Retry-After period.
503 service_unavailable A dependency is temporarily unavailable; retry after the Retry-After period.

Example

curl -i -X POST "https://api.eu.keenauth.com/v1/invitations/inv_01j9xt9v3w4y8z0a2b4c6d8e0g:resend" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Personal data

This endpoint carries personal data: organization memberships and invitations. Personal data in the KeenAuth APIs describes what is stored, how long it is kept and how it is deleted. Do not send special categories of personal data (health, biometric data, religion, political opinions, sexual orientation) in any field.