# Eine Anwendung fortsetzen

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

Setzt den `status` einer ausgesetzten Anwendung zurück auf `active`, sodass sie wieder Tokens erhalten kann. Ihre Client-Zugangsdaten funktionieren weiterhin, doch Refresh-Token-Familien, die durch die Aussetzung widerrufen wurden, bleiben widerrufen: Die Benutzer der Anwendung melden sich erneut an, um neue Tokens zu erhalten. Die Anfrage hat keinen Body (leer oder `{}`). Das Fortsetzen einer bereits aktiven Anwendung ändert nichts und liefert die aktuelle Anwendung mit derselben Version. Die Änderung wird als `application.updated` im Verwaltungs-Audit-Log protokolliert und als Ereignisse `application_changed` und `application_status_changed` veröffentlicht.

## Anfrage

**Header**: `If-Match: "<version>"` (optional). Mit `If-Match` gilt die Änderung nur für diese Version (sonst `412`); ohne Header wird die neueste Version verwendet, und die Anfrage wird wiederholt, wenn ein anderer Schreibvorgang die Anwendung gleichzeitig ändert. Senden Sie einen `Idempotency-Key`-Header, damit Wiederholungen sicher sind.

| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
| `application_id` | path | ja | Anwendungs-ID, mit `app_` beginnend. |

## Antwort

`200 OK` mit der Anwendung (`"status": "active"`) und ihrem `ETag`.

## Fehler

Jeder Fehler ist ein `application/problem+json`-Body mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 400 | `malformed_request`, `unknown_field` | Ein Body wurde gesendet, der kein gültiges JSON ist oder ein Feld enthält. |
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Der Schlüssel hat nicht die Berechtigung `applications:write`. |
| 404 | `not_found` | Die Anwendung existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft). |
| 412 | `precondition_failed` | Die Version in `If-Match` ist veraltet. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; `Retry-After` beachten. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; später erneut versuchen. |

## Beispiel

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