
# Deprovisionierungssperre genehmigen

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

Genehmigt die Massen-Deprovisionierungssperre des Verzeichnisses: Die zurückgehaltenen Deprovisionierungen werden angewendet. Protokolliert als `directory.deprovision_hold_approved`. Eine Sperre, die nicht mehr offen ist, oder die ihr 72-Stunden-Zeitlimit überschritten hat (sie wird durch das Zeitlimit genehmigt, und diese Entscheidung wird nicht angewendet), liefert `409 conflict`.

## Anfrage

| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `directory_id` | path | ja | SCIM-Verzeichnis-ID (`dir_…`). |
| `hold_id` | path | ja | Die Sperr-ID: `open_deprovision_hold.id` aus `GET /v1/directories/{directory_id}` (UUID in Kleinbuchstaben). |

Es gibt keinen Anfrage-Body.

## Antwort

`200 OK` mit der Entscheidung.

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

## Fehler

| HTTP | code | Wann |
|---|---|---|
| 404 | `not_found` | Das Verzeichnis oder die Sperre existiert nicht in dieser Umgebung, oder die Sperre gehört zu einem anderen Verzeichnis. |
| 409 | `conflict` | Über die Sperre wurde bereits entschieden, oder sie hat ihr 72-Stunden-Zeitlimit überschritten. |
| 401 | `unauthenticated` | Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; nach Ablauf des `Retry-After`-Zeitraums erneut versuchen. |
| 503 | `service_unavailable` | Die Verzeichnissynchronisation ist vorübergehend nicht verfügbar oder in diesem Deployment nicht konfiguriert; nach Ablauf des `Retry-After`-Zeitraums erneut versuchen. |

## Beispiel

```bash
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)"
```
