> ## 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.

# Umgebungsvariablen

> Umgebungsvariablen einer Anwendung auflisten, hinzufügen, ersetzen und löschen.

`app.envs` stellt das [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts) bereit, mit dem du die `KEY=value`-Paare verwalten kannst, die deine Anwendung zur Laufzeit sieht.

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

Jede Methode löst nach Abschluss der Operation zum vollständigen Env-Set auf — du erhältst also stets eine aktuelle `{ key: value }`-Map zurück.

## Umgebungsvariablen auflisten

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

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

## Variablen hinzufügen oder aktualisieren

`app.envs.set(envs)` führt neue Variablen in das bestehende Set zusammen. Vorhandene Schlüssel, die nicht im Aufruf enthalten sind, bleiben erhalten.

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

## Das gesamte Env-Set ersetzen

`app.envs.replace(envs)` überschreibt jede Variable. Alles, was nicht aufgeführt ist, wird **entfernt**.

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

Übergib ein leeres Objekt, um alle Variablen zu löschen:

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

## Variablen löschen

`app.envs.delete(keys)` entfernt die aufgeführten Schlüssel. Unbekannte Schlüssel werden stillschweigend ignoriert.

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