# Obtener el entorno actual

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

Devuelve el entorno al que pertenece la credencial que realiza la llamada: su ID, tipo, región, celda, estado y plan. El entorno siempre proviene de la credencial; este endpoint no puede leer otro entorno. El endpoint es de solo lectura y está disponible en todos los planes. El data source de OpenTofu/Terraform `keenauth_environment` lo lee.

## Solicitud

Sin parámetros.

## Respuesta

`200 OK`

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

| Campo | Descripción |
|---|---|
| `id` | ID del entorno (`env_…`). |
| `type` | `development`, `staging` o `production`. Nunca cambia. |
| `region` | Región de datos (`eu`, `us`). El host de la API de gestión es `api.<region>.keenauth.com`. |
| `cell_id` | Celda que atiende el entorno, por ejemplo `eu1`. |
| `state` | `active`, `suspended_dashboard`, `suspended_nonprod`, `export_only` o `deleting`. |
| `plan` | `free`, `startup`, `business`, `enterprise` o `internal`; `null` hasta que el plan llegue a la celda. No suponga un plan cuando sea `null`. |

Esta versión no devuelve el nombre para mostrar, la fecha de creación, el host predeterminado ni los dominios personalizados. `GET /v1/custom-domains` enumera los dominios personalizados.

## Errores

| HTTP | código | Cuándo |
|---|---|---|
| 403 | `insufficient_permissions` | La credencial no tiene `environment-settings:read`. |
| 503 | `service_unavailable` | No se pudo leer el registro de entornos; reintente más tarde. |

## Ejemplo

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

CLI: `keenauth environment get`