# アプリケーションを再開

`POST /v1/applications/{application_id}:resume` · 権限 `applications:write`

一時停止中のアプリケーションの `status` を `active` に戻し、再びトークンを取得できるようにします。そのクライアント資格情報は引き続き有効ですが、一時停止によって取り消されたリフレッシュトークンファミリーは取り消されたままです。アプリケーションのユーザーは、新しいトークンを得るために再度サインインする必要があります。リクエストにボディはありません(空または `{}`)。既にアクティブなアプリケーションを再開しても何も変わらず、同じバージョンの現在のアプリケーションを返します。この変更は管理監査ログに `application.updated` として書き込まれ、`application_changed` および `application_status_changed` イベントとして公開されます。

## リクエスト

**ヘッダー**: `If-Match: "<version>"`(任意)。`If-Match` を付けると、変更はそのバージョンに対してのみ適用されます(それ以外は `412`)。付けない場合は最新バージョンが使われ、別の書き込みが同時にアプリケーションを変更すると、リクエストは再試行されます。再試行を安全にするには、`Idempotency-Key` ヘッダーを送信してください。

| パラメーター | 位置 | 必須 | 説明 |
|---|---|---|---|
| `application_id` | path | はい | アプリケーション ID。接頭辞は `app_`。 |

## レスポンス

`200 OK` とアプリケーション(`"status": "active"`)、およびその `ETag` を返します。

## エラー

すべてのエラーは、安定した `code` を持つ `application/problem+json` 本文です。

| HTTP | `code` | 発生条件 |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | 有効な JSON ではない、またはフィールドを持つ本文が送信された場合。 |
| 401 | `unauthenticated` | API キーがない、無効である、または取り消されている場合。 |
| 403 | `insufficient_permissions` | キーに `applications:write` 権限がない場合。 |
| 404 | `not_found` | この環境にアプリケーションが存在しない場合(または ID の形式が不正な場合)。 |
| 412 | `precondition_failed` | `If-Match` のバージョンが古い場合。 |
| 429 | `rate_limited` | レート制限を超えた場合。`Retry-After` に従ってください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できない場合。後で再試行してください。 |

## 例

```bash
curl -X POST https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg:resume \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "4"'
```

CLI: `keenauth applications resume app_6f8d0cjgbmf0gtn2rg6pscp3cg --if-match '"4"'`