Bir kuruluşun davetlerini listele

GET /fapi/v1/organizations/{org_id}/invitations · ortamın oturum açma sunucusundan çağrılır

Bir kuruluşun davetlerini, oluşturulma sırasına göre listeler. Bir kuruluş profili ekranında kullanılır. Bekleyen bir davet, yalnızca idp_members:read iznine de sahipseniz davet edilen e-posta adresini gösterir; aksi halde email değeri null olur. Kabul edilen, iptal edilen ve süresi dolan davetlerde hiçbir zaman e-posta adresi bulunmaz.

Kimliği doğrulanmış kullanıcının __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.

@keenauth/js ile: await keenauth.organizations.invitations(orgId, { status: "pending" }).

İstek

Üstbilgiler:

Üstbilgi	Zorunlu	Açıklama
`Idp-Client`	evet	SDK tanımlayıcısı.

org_id: kuruluş tanımlayıcısı (org_…).

Sorgu parametreleri:

Parametre	Zorunlu	Açıklama
`status`	hayır	`pending`, `accepted`, `revoked` veya `expired`; atlanırsa dördü de döner.
`after`	hayır	Önceki sayfanın `next_after` değeri.
`limit`	hayır	1–100, varsayılan 20.

Gövde yoktur.

Yanıt

200 OK ile {"data": [...], "next_after": "..."} döner; next_after son sayfada bulunmaz. Her öğe, bir davet alanlarına sahiptir.

Hatalar

Durum	Kod	Ne zaman
400	`invalid_cursor`	`after` hatalı biçimdedir.
401	`unauthenticated`	Geçerli bir oturum çerezi veya belirteci yoktur.
403	`insufficient_permissions`	Kullanıcının kuruluşta `idp_members:invite` izni yoktur.
404	`not_found`	Bu kullanıcı için böyle bir kuruluş yoktur; bilinmeyen, hatalı biçimli veya başka bir kuruluşa ait tanımlayıcılar da aynı yanıtı verir.
422	`validation_failed`	`status` veya `limit` geçersizdir.
503	`service_unavailable`	Geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/invitations?status=pending&limit=1" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
      "email": "new.member@example.com",
      "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
      "delivery": "email",
      "delivery_status": "sent",
      "status": "pending",
      "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": null,
      "created_at": "2026-11-03T10:00:00Z",
      "updated_at": "2026-11-03T10:00:00Z",
      "version": 1
    }
  ],
  "next_after": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d"
}

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.