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

{
  "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

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

CLI: keenauth environment get