Toplu hesap kaldırma beklemelerini listeleyin

GET /v1/directories/{directory_id}/deprovision-holds · izin directories:read

Dizinin toplu hesap kaldırma beklemelerini, açık ve karara bağlanmış olanları, en yeniden en eskiye doğru listeler: beklemeye alınan hesap kaldırma işlemlerinin sayısını, durumu ve kararı gösterir; beklemedeki kullanıcıları asla göstermez. Açık bir bekleme, POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:approve veya :reject ile onaylanır ya da reddedilir; 72 saat sonra zaman aşımı yoluyla onaylanır. Yalnızca ileri sayfalama vardır; imleç dizine bağlıdır.

İstek

Alan Tür Zorunlu Açıklama
directory_id yol evet SCIM dizin kimliği (dir_…).
limit sorgu hayır 1–100, varsayılan 20.
after sorgu hayır list_metadata.after değerinden gelen imleç.

İstek gövdesi yoktur.

Yanıt

Bekleme kayıtlarından oluşan bir sayfa içeren 200 OK.

{
  "data": [
    {
      "id": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "status": "approved",
      "opened_at": "2026-10-20T09:00:00Z",
      "pending_count": 42,
      "decided_by": "api_key:key_01j9xr6s8t0v2w4x6y8z0a2b4d",
      "decided_at": "2026-10-20T10:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

status değeri open, approved veya rejected olabilir. decided_by değeri api_key:<key ID>, admin_portal_link:apl_… veya timeout olur; bekleme açıkken bu alan ve decided_at null değerindedir.

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç geçersiz veya başka bir dizine ait.
404 not_found Dizin bu ortamda mevcut değil.
422 validation_failed limit aralık dışında veya before ya da order verilmiş (unsupported).
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Dizin senkronizasyonu geçici olarak kullanılamıyor veya bu dağıtımda yapılandırılmamış; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/deprovision-holds?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Kişisel veriler

Bu uç nokta kişisel veri içerir: dizin (SCIM) kullanıcıları. KeenAuth API'lerinde kişisel veriler sayfası, 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.