Variáveis de ambiente

app.envs expõe o EnvsModule, que permite gerenciar os pares CHAVE=valor visíveis à aplicação em tempo de execução.

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.

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

Listando as variáveis

const envs = await app.envs.list();

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

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

await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});

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

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:

await app.envs.replace({});

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

await app.envs.delete(["FEATURE_FLAG"]);