# Abilita o disabilita un'applicazione in un'organizzazione

`PUT /v1/organizations/{org_id}/applications/{application_id}` · permesso `organizations:write`

Imposta lo stato dell'applicazione nell'organizzazione. Riscrivere lo stato attuale non ha effetto e mantiene la versione. `If-Match` è facoltativo; se fornito, deve corrispondere all'`ETag` attuale. La disabilitazione mantiene le assegnazioni, che tornano ad applicarsi quando l'applicazione viene riabilitata. Le scritture sono registrate nel registro di audit di gestione come `organization_application.enabled` o `organization_application.disabled`.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `org_id` | path | sì | ID dell'organizzazione (`org_…`). |
| `application_id` | path | sì | ID dell'applicazione (`app_…`). |
| `If-Match` | header | no | Facoltativo. L'`ETag` attuale (`"0"` per una riga mai scritta); in caso di mancata corrispondenza, `412`. |
| `status` | string | sì | `enabled` o `disabled`. |

## Risposta

`200 OK` con la riga di accesso e il nuovo `ETag`.

```json
{
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "application_id": "app_01j9xm4n8r9s3t5v7w9x1y3z5b",
  "status": "enabled",
  "enabled_at": "2026-10-12T09:30:00.123456Z",
  "updated_at": "2026-10-12T09:30:00.123456Z",
  "version": 1
}
```

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | L'organizzazione o l'applicazione non esiste in questo ambiente. |
| 409 | `organization_pending_deletion` | Abilitazione in un'organizzazione in attesa di eliminazione. |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione attuale; con `"0"`, un\'altra richiesta ha scritto prima la riga. |
| 422 | `validation_failed` | `status` manca oppure non è `enabled`/`disabled`. |
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; riprova dopo il periodo `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo `Retry-After`. |

## Esempio

```bash
curl -i -X PUT "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/applications/app_01j9xm4n8r9s3t5v7w9x1y3z5b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "0"' \
  -d '{"status":"enabled"}'
```