> ## 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 d'environnement

> Listez, ajoutez, remplacez et supprimez les variables d'environnement d'une application.

`app.envs` expose le [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts), qui vous permet de gérer les paires `KEY=value` que votre application voit à l'exécution.

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

Chaque méthode se résout avec l'ensemble complet des variables une fois l'opération terminée — vous récupérez donc toujours une map `{ key: value }` à jour.

## Lister les variables d'environnement

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

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

## Ajouter ou mettre à jour des variables

`app.envs.set(envs)` fusionne les nouvelles variables dans l'ensemble existant. Les clés existantes absentes de l'appel sont conservées.

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

## Remplacer l'ensemble complet des variables

`app.envs.replace(envs)` écrase toutes les variables. Tout ce qui n'est pas listé est **supprimé**.

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

Passez un objet vide pour effacer toutes les variables :

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

## Supprimer des variables

`app.envs.delete(keys)` supprime les clés listées. Les clés inconnues sont ignorées silencieusement.

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