Bir daveti iptal et
POST /fapi/v1/organizations/{org_id}/invitations/{invitation_id}:revoke · ortamın oturum açma sunucusundan çağrılır
Bekleyen bir daveti iptal eder. Yanıt, iptal edilmiş daveti içerir; adresi silinmiştir (email değeri null olur). Artık bekleyen durumda olmayan bir davet (kabul edilmiş, süresi dolmuş veya zaten iptal edilmiş) 422 invitation_invalid döner.
Kimliği doğrulanmış kullanıcının tam eşleşen Origin değerine sahip __Host-idp_session çerezi veya birinci taraf bir uygulamanın ön API erişim belirteci (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön API erişim belirteci) gereklidir. Kullanıcı, kuruluşun etkin bir üyesi olmalı ve idp_members:invite iznine sahip olmalıdır. Üye olmayan bir kullanıcı 404 not_found yanıtı alır; izni olmayan bir üye 403 insufficient_permissions yanıtı alır. Ayrıcalıklı bir rol taşıyan bir daveti yalnızca yönetici rolüne sahip bir üye iptal edebilir (403 role_not_assignable).
@keenauth/js ile: await keenauth.organizations.revokeInvitation(orgId, invitationId).
İstek
Üstbilgiler:
| Üstbilgi | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
çerezle birlikte evet | https://<oturum açma sunucusu>. |
org_id: kuruluş tanımlayıcısı (org_…). invitation_id: davet tanımlayıcısı (inv_…), davetin id değeri.
Gövde yoktur.
Yanıt
200 OK ile davet ve ETag: "<version>" döner.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi veya belirteci yoktur. |
| 403 | insufficient_permissions |
Kullanıcının kuruluşta idp_members:invite izni yoktur. |
| 403 | role_not_assignable |
Davet ayrıcalıklı bir rol taşıyor ve kullanıcı yönetici rolüne sahip değil. |
| 403 | origin_not_allowed |
Origin eşleşmiyor. |
| 404 | not_found |
Bu kullanıcı için böyle bir kuruluş veya davet yoktur; bilinmeyen, hatalı biçimli veya başka bir kuruluşa ait tanımlayıcılar da aynı yanıtı verir. |
| 409 | organization_disabled |
Kuruluş devre dışı bırakılmış veya silinmeyi bekliyor (organization_pending_deletion). |
| 422 | invitation_invalid |
Davet bekleyen durumda değil. |
| 503 | service_unavailable |
Geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin. |
Örnek
curl -X POST "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations/inv_01jbz6x8kq3m2n4p5r6s7t8v9d:revoke" \
-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": null,
"role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
"delivery": "email",
"delivery_status": "sent",
"status": "revoked",
"send_count": 1,
"last_sent_at": "2026-11-03T10:00:00Z",
"expires_at": "2026-11-10T10:00:00Z",
"accepted_user_id": null,
"accepted_at": null,
"revoked_at": "2026-11-03T11:00:00Z",
"created_at": "2026-11-03T10:00:00Z",
"updated_at": "2026-11-03T11:00:00Z",
"version": 2
}
Kişisel veriler
Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süreyle tutulduğu ve nasıl silindiği açıklanmaktadır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.