Davetiyeyi yeniden gönder

POST /v1/invitations/{invitation_id}:resend · İzin invitations:write

Bekleyen bir daveti yeni bir belirteçle yeniden gönderir: önceki bağlantı çalışmayı durdurur. email davetleri için yeni bağlantı yalnızca e-posta ile gönderilir ve yanıtta accept_url bulunmaz. link_only davetleri için kabul bağlantısı (accept_url) yalnızca bu yanıtta, bir kez döndürülür; hiçbir uç nokta bunu daha sonra döndürmez. Yanıt Cache-Control: no-store içerir; aynı Idempotency-Key için tekrar oynatılan bir yanıt bağlantıyı içermez ve secret_redacted: true taşır. Yeniden göndermeler arasında en az 10 dakika olmalı ve toplamda en fazla 5 gönderim yapılabilir; expires_at değişmez. Yazma işlemi invitation.resent olarak denetlenir.

İstek

Alan Tür Zorunlu Açıklama
invitation_id path evet Davet kimliği (inv_…).

İstek gövdesi yok.

Yanıt

200 OK ile davet ve yeni kabul bağlantısı.

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

Hatalar

HTTP code Ne zaman
404 not_found Davet bu ortamda mevcut değil.
409 conflict Davet bekleyen durumda değil.
429 invite_rate_limited Son gönderimden bu yana 10 dakikadan az süre geçtiyse veya zaten 5 gönderim yapıldıysa.
501 not_implemented Davet email ile gönderiliyor ve dağıtım için davet e-postası yapılandırılmamış.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisi gerekli izne sahip değil.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

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

Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.