Obtener variables de entorno de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/envs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/envs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/envs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/envs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "env-abc123",
"key": "API_KEY",
"value": "secret123",
"note": "API key for external service",
"created_at": "2026-03-20T19:58:00Z"
},
{
"id": "env-xyz789",
"key": "DATABASE_URL",
"value": "mysql://user:pass@database-host/db",
"note": null,
"created_at": "2026-03-20T19:58:00Z"
}
]
}
Variables de entorno
Obtener variables de entorno de la aplicación
Devuelve todas las variables de entorno de una aplicación a partir de su ID.
GET
/
v1
/
apps
/
{id}
/
envs
Obtener variables de entorno de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/envs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/envs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/envs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/envs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "env-abc123",
"key": "API_KEY",
"value": "secret123",
"note": "API key for external service",
"created_at": "2026-03-20T19:58:00Z"
},
{
"id": "env-xyz789",
"key": "DATABASE_URL",
"value": "mysql://user:pass@database-host/db",
"note": null,
"created_at": "2026-03-20T19:58:00Z"
}
]
}
string
requerido
El ID de la aplicación de la que se quieren obtener las variables de entorno.
string
Si la aplicación pertenece a un workspace, el ID de ese workspace. Obligatorio para los miembros del workspace que actúan sobre una aplicación que no les pertenece.
Respuesta
array
Un array de objetos de variable de entorno.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la variable de entorno.
string
La clave de la variable de entorno.
string
El valor de la variable de entorno (descifrado).
string | null
La nota o descripción opcional de la variable de entorno.
object | null
Se establece cuando una conexión de un stack gestiona la variable: la plataforma la mantiene actualizada. Si la editas a mano, pasa a ser una variable normal.
null para una variable que te pertenece.string
La fecha y hora en que se creó la variable de entorno.
{
"response": [
{
"id": "env-abc123",
"key": "API_KEY",
"value": "secret123",
"note": "API key for external service",
"created_at": "2026-03-20T19:58:00Z"
},
{
"id": "env-xyz789",
"key": "DATABASE_URL",
"value": "mysql://user:pass@database-host/db",
"note": null,
"created_at": "2026-03-20T19:58:00Z"
}
]
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (403).ACCESS_DENIED: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (403).FORBIDDEN: El usuario no tiene permiso para acceder a la aplicación.APP_NOT_FOUND: La aplicación indicada no existe.
string
Una descripción detallada con información adicional sobre el error.
{
"code": "ACCESS_DENIED"
}
{
"code": "APP_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026