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

# Variáveis de ambiente

> Liste, adicione, substitua e remova variáveis de ambiente de uma aplicação.

`app.envs` expõe o [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts), que permite gerenciar os pares `CHAVE=valor` visíveis à aplicação em tempo de execução.

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

Todos os métodos retornam o conjunto completo de variáveis após a operação — você sempre recebe um mapa `{ chave: valor }` atualizado.

<Note>
  Limites: até 256 variáveis por aplicação, chaves com até 1024 caracteres e valores com até 4096 caracteres.
</Note>

## Listando as variáveis

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

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

## Adicionando ou atualizando variáveis

`app.envs.set(envs)` mescla novas variáveis ao conjunto existente. Chaves não mencionadas na chamada são preservadas.

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

## Substituindo o conjunto inteiro

`app.envs.replace(envs)` sobrescreve todas as variáveis. Tudo que não estiver na chamada é **removido**.

```typescript theme={null}
await app.envs.replace({
    DATABASE_URL: "postgres://novo-host...",
});
// FEATURE_FLAG não existe mais
```

Passe um objeto vazio para apagar todas as variáveis:

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

## Removendo variáveis

`app.envs.delete(keys)` remove as chaves listadas. Chaves desconhecidas são ignoradas silenciosamente.

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