Dizini sil

DELETE /v1/directories/{directory_id} · izin directories:write

Dizini anında ve kalıcı olarak siler: token'ları (kimlik sağlayıcısının SCIM istekleri bundan sonra 401 alır), bekletmeleri, grupları, grup üyelikleri ve dizin kullanıcı kayıtları aynı işlemde silinir. Silme directory.deleted olarak denetlenir. Zaten silinmiş dizini silmek 404 döner.

İstek

Alan Tür Zorunlu Açıklama
directory_id path evet SCIM dizini kimliği (dir_…).

İstek gövdesi yoktur.

Yanıt

204 No Content.

Hatalar

HTTP code Ne zaman
404 not_found Dizin bu ortamda yok.
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Dizin eşitleme geçici olarak kullanılamıyor ya da bu kurulumda yapılandırılmamış; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i -X DELETE "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"