
# デプロビジョニング保留の承認

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

ディレクトリの一括デプロビジョニング保留を承認します。保留されていたデプロビジョニングが適用されます。`directory.deprovision_hold_approved` として監査されます。もう開いていない保留、または72時間のタイムアウトを過ぎた保留（タイムアウトにより承認済みとなり、この決定は適用されません）は `409 conflict` を返します。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `directory_id` | path | はい | SCIMディレクトリID（`dir_…`）。 |
| `hold_id` | path | はい | 保留ID。`GET /v1/directories/{directory_id}` の `open_deprovision_hold.id`（小文字のUUID）。 |

リクエストボディはありません。

## レスポンス

`200 OK` と決定結果を返します。

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

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | ディレクトリまたは保留がこの環境に存在しない、または保留が別のディレクトリのものです。 |
| 409 | `conflict` | 保留にはすでに決定が下されたか、72時間のタイムアウトを過ぎています。 |
| 401 | `unauthenticated` | 認証情報がない、無効、または失効しています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。 |
| 503 | `service_unavailable` | ディレクトリ同期が一時的に利用できないか、このデプロイメントで構成されていません。`Retry-After` の期間を待ってから再試行してください。 |

## 例

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