Bir kullanıcının üyeliklerini listeleyin

GET /v1/users/{user_id}/memberships · izin users:read

Kullanıcının kuruluş üyeliklerini kuruluş kimliğine göre artan sırada listeler. Yalnızca ileri sayfalama desteklenir; list_metadata.after değeri null olana kadar takip edin. İmleç kullanıcıya ve status filtresine bağlıdır. status olmadan liste invited, active ve suspended üyeliklerini içerir; kaldırılmış üyelikler yalnızca status=removed ile gelir. Bilinmeyen bir kullanıcı 404 döndürür.

İstek

Alan Tür Zorunlu Açıklama
user_id path evet Kullanıcı kimliği (usr_…).
limit query hayır 1–100, varsayılan 20.
after query hayır list_metadata.after değerinden alınan imleç.
status query hayır invited, active, suspended veya removed.

Yanıt

200 OK ile bir sayfa üyelik döner.

{
  "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-12T10:00:00Z",
      "version": 2
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç geçersiz veya başka bir kullanıcıya ya da filtreye ait.
404 not_found Kullanıcı bu ortamda mevcut değil.
422 validation_failed status veya limit geçersiz ya da tekrarlanmış; ya da before veya asc dışında bir order verilmiş.
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/users/usr_01j9xh2k6p7q1r3s5t7v9w1x3y/memberships?status=active&limit=20" \
  -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 veri (sağlık, biyometrik veri, din, siyasi görüşler, cinsel yönelim) göndermeyin.