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

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

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