Approuver une suspension de désactivation

POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:approve · autorisation directories:write

Approuve la suspension de désactivation en masse de l'annuaire : les désactivations suspendues sont appliquées. Auditée sous directory.deprovision_hold_approved. Une suspension qui n'est plus ouverte, ou qui a dépassé son délai de 72 heures (elle est approuvée par le délai et cette décision n'est pas appliquée), renvoie 409 conflict.

Requête

Champ	Type	Obligatoire	Description
`directory_id`	path	oui	Identifiant de l'annuaire SCIM (`dir_…`).
`hold_id`	path	oui	Identifiant de la suspension : `open_deprovision_hold.id` de `GET /v1/directories/{directory_id}` (UUID en minuscules).

Il n'y a pas de corps de requête.

Réponse

200 OK avec la décision.

{
  "id": "0192a3c0-1d2e-7f3a-8b4c-5d6e7f8a9b0c",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "status": "approved"
}

Erreurs

HTTP	code	Quand
404	`not_found`	L'annuaire ou la suspension n'existe pas dans cet environnement, ou la suspension appartient à un autre annuaire.
409	`conflict`	La suspension a déjà fait l'objet d'une décision ou a dépassé son délai de 72 heures.
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 POST "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/deprovision-holds/0192a3c0-1d2e-7f3a-8b4c-5d6e7f8a9b0c:approve" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"