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"