# Ottenere l'ambiente corrente

`GET /v1/environment` · permesso `environment-settings:read`

Restituisce l'ambiente a cui appartiene la credenziale chiamante: il suo ID, il tipo, la regione, la cella, lo stato e il piano. L'ambiente proviene sempre dalla credenziale; questo endpoint non può leggere un altro ambiente. L'endpoint è di sola lettura ed è disponibile in ogni piano. La data source OpenTofu/Terraform `keenauth_environment` lo legge.

## Richiesta

Nessun parametro.

## Risposta

`200 OK`

```json
{
  "id": "env_01h455vb4pex5vsknk084sn02q",
  "type": "production",
  "region": "eu",
  "cell_id": "eu1",
  "state": "active",
  "plan": "business"
}
```

| Campo | Descrizione |
|---|---|
| `id` | ID dell'ambiente (`env_…`). |
| `type` | `development`, `staging` o `production`. Non cambia mai. |
| `region` | Regione dei dati (`eu`, `us`). L'host dell'API di gestione è `api.<region>.keenauth.com`. |
| `cell_id` | Cella che serve l'ambiente, per esempio `eu1`. |
| `state` | `active`, `suspended_dashboard`, `suspended_nonprod`, `export_only` o `deleting`. |
| `plan` | `free`, `startup`, `business`, `enterprise` o `internal`; `null` finché il piano non ha raggiunto la cella. Non presumere un piano quando è `null`. |

Questa versione non restituisce il nome visualizzato, l'ora di creazione, l'host predefinito o i domini personalizzati. `GET /v1/custom-domains` elenca i domini personalizzati.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 403 | `insufficient_permissions` | La credenziale non ha `environment-settings:read`. |
| 503 | `service_unavailable` | Non è stato possibile leggere il registro degli ambienti; riprova più tardi. |

## Esempio

```bash
curl -i https://api.eu.keenauth.com/v1/environment \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth environment get`