> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Variables de entorno

> Lista, agrega, reemplaza y elimina las variables de entorno de una aplicación.

`app.envs` expone el [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts), que te permite gestionar los pares `KEY=value` que tu aplicación ve en tiempo de ejecución.

```typescript theme={null}
const app = await api.applications.fetch("abc123def456abc123def456");
app.envs; // EnvsModule
```

Cada método se resuelve con el conjunto completo de variables tras completarse la operación, de modo que siempre recibes de vuelta un mapa `{ key: value }` actualizado.

## Listado de variables de entorno

```typescript theme={null}
const envs = await app.envs.list();

console.log(envs);
// { DATABASE_URL: "postgres://...", FEATURE_FLAG: "true" }
```

## Agregar o actualizar variables

`app.envs.set(envs)` fusiona nuevas variables con el conjunto existente. Las claves existentes que no aparezcan en la llamada se conservan.

```typescript theme={null}
await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});
```

## Reemplazo de todo el conjunto de variables

`app.envs.replace(envs)` sobrescribe todas las variables. Cualquier variable no listada se **elimina**.

```typescript theme={null}
await app.envs.replace({
    DATABASE_URL: "postgres://new-host...",
});
// FEATURE_FLAG is now gone
```

Pasa un objeto vacío para borrar todas las variables:

```typescript theme={null}
await app.envs.replace({});
```

## Eliminación de variables

`app.envs.delete(keys)` elimina las claves indicadas. Las claves desconocidas se ignoran silenciosamente.

```typescript theme={null}
await app.envs.delete(["FEATURE_FLAG"]);
```