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