api.apps.envs. Todo método recebe o id da aplicação primeiro e retorna as variáveis da aplicação como um Record<string, string> simples.
Os exemplos usam o cliente api de Criando o cliente. appId é o id de uma das suas aplicações: api.account.me() lista todas.
Aplicações estáticas não têm variáveis de ambiente: todos os métodos respondem 400
STATIC_APP_ENV_NOT_SUPPORTED. Uma alteração entra em vigor no próximo reinício.Lendo as variáveis
Adicionando ou atualizando variáveis
envs.set(appId, envs) adiciona as chaves informadas e sobrescreve as que já existem. As outras variáveis são mantidas. Retorna todas as variáveis após a alteração.
Substituindo todas as variáveis
envs.replace(appId, envs) substitui todas as variáveis pelo conjunto informado. As chaves que não estão no objeto são removidas.
Removendo variáveis
envs.delete(appId, keys) remove as chaves informadas e retorna as variáveis restantes.
Limites e erros
Próximos passos
Deploys
Faça deploy a cada push, com um webhook ou o GitHub App.
Referência da API de variáveis de ambiente
Os endpoints REST por trás destes métodos.
Variáveis pela CLI
As mesmas ações pelo terminal.
Variáveis no seu código
Defina variáveis pelo dashboard, pela CLI ou pela API e leia-as em tempo de execução.