Supprimer un annuaire
DELETE /v1/directories/{directory_id} · autorisation directories:write
Supprime l'annuaire immédiatement et définitivement : ses jetons (les requêtes SCIM du fournisseur d'identité reçoivent alors 401), ses suspensions de désactivation, ses groupes, ses appartenances aux groupes et ses enregistrements d'utilisateurs d'annuaire sont supprimés dans la même transaction. La suppression est auditée sous directory.deleted. Supprimer un annuaire déjà supprimé renvoie 404.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
directory_id |
path | oui | Identifiant de l'annuaire SCIM (dir_…). |
Il n'y a pas de corps de requête.
Réponse
204 No Content.
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 404 | not_found |
L'annuaire n'existe pas dans cet environnement. |
| 401 | unauthenticated |
L'identifiant est absent, invalide ou révoqué. |
| 403 | insufficient_permissions |
L'identifiant ne dispose pas de l'autorisation requise. |
| 429 | rate_limited |
La limite de débit a été dépassée ; réessayez après la période Retry-After. |
| 503 | service_unavailable |
La synchronisation des annuaires est temporairement indisponible ou non configurée dans ce déploiement ; réessayez après la période Retry-After. |
Exemple
curl -i -X DELETE "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"