Bir kuruluşun üyeliklerini listele

GET /v1/organizations/{org_id}/memberships · izin organizations:read

Kuruluşun üyeliklerini son güncellemeye göre, en eskiden başlayarak listeler (eşitlik durumunda kimliğe göre). Yalnızca ileri yönde sayfalama desteklenir. Filtreler: status, role_id, updated_after. İmleç kuruluşa ve filtrelere bağlıdır.

İstek

Alan Tür Zorunlu Açıklama
org_id yol evet Kuruluş kimliği (org_…).
limit sorgu hayır 1–100, varsayılan 20.
after sorgu hayır list_metadata.after değerinden alınan imleç.
status sorgu hayır invited, active, suspended veya removed.
role_id sorgu hayır Yalnızca bu rolü taşıyan üyelikler (rol_…).
updated_after sorgu hayır RFC 3339 zamanı; yalnızca bu zamandan sonra güncellenen üyelikler.

İstek gövdesi yok.

Yanıt

Üyelik sayfası ile birlikte 200 OK.

{
  "data": [
    {
      "id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "user_id": "usr_01j9xh2k6p7q1r3s5t7v9w1x3y",
      "status": "active",
      "source": "admin_api",
      "reason": null,
      "roles": [
        {
          "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
          "source": "admin_api",
          "assigned_at": "2026-10-12T09:31:00.123456Z"
        }
      ],
      "expires_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "activated_at": "2026-10-12T09:31:00.123456Z",
      "suspended_at": null,
      "removed_at": null,
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

HTTP kod Ne zaman
400 invalid_cursor İmleç geçersiz veya başka bir kuruluşa ya da filtreye ait.
404 not_found Kuruluş bu ortamda mevcut değil.
422 validation_failed Bir filtre veya limit geçersiz ya da before ya da asc dışında bir order verildi.
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 "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç noktada kuruluş üyelikleri ve davetler gibi kişisel veriler bulunur. 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.