Variáveis de Ambiente

As variáveis de ambiente são configuradas por aplicação nas rotas REST /v1/apps/:id/envs da API v1. As operações de escrita salvam a configuração; elas não reiniciam a aplicação automaticamente. Para aplicar valores atualizados, chame sonder.apps.restart(appId) ou a rota POST /v1/apps/:id/restart.

GET /v1/apps/:id/envs e as respostas de escrita retornam valores sem mascaramento, inclusive segredos. Proteja o token de API e evite registrar ou exibir essas respostas em logs, interfaces públicas ou ferramentas de observabilidade.

Operações

Método HTTP	Rota	Comportamento
`GET`	`/v1/apps/:id/envs`	Lista as variáveis atuais e seus valores.
`POST`	`/v1/apps/:id/envs`	Mescla variáveis: cria novas chaves e atualiza as informadas.
`PATCH`	`/v1/apps/:id/envs`	Mescla variáveis, com o mesmo comportamento do `POST`.
`PUT`	`/v1/apps/:id/envs`	Substitui o conjunto completo; chaves omitidas são removidas.
`DELETE`	`/v1/apps/:id/envs`	Remove as chaves indicadas no array `keys`.

As requisições exigem Authorization: Bearer <token> e um appId em formato UUID v4. Para detalhes por operação, consulte GET, POST, PATCH, PUT e DELETE.

Consultar

curl 'https://api.sondercloud.app/v1/apps/APP_ID/envs' \
  -H 'Authorization: Bearer SEU_TOKEN'

Resposta:

{
  "success": true,
  "appId": "APP_ID",
  "envs": {
    "NODE_ENV": "production",
    "API_KEY": "valor-secreto"
  }
}

Adicionar ou atualizar

Envie apenas as chaves que deseja criar ou alterar. As demais permanecem salvas.

curl -X PATCH 'https://api.sondercloud.app/v1/apps/APP_ID/envs' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  --data '{"envs":{"NODE_ENV":"production","API_KEY":"substitua-pelo-segredo"}}'

Substituir o conjunto completo

O corpo representa o conjunto desejado inteiro. Chaves que existiam, mas foram omitidas, são removidas.

curl -X PUT 'https://api.sondercloud.app/v1/apps/APP_ID/envs' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  --data '{"envs":{"NODE_ENV":"production"}}'

Remover chaves

O corpo deve conter um array keys não vazio.

curl -X DELETE 'https://api.sondercloud.app/v1/apps/APP_ID/envs' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  --data '{"keys":["API_KEY"]}'

Formato e limites

São permitidas até 256 variáveis por aplicação.
O nome deve ter até 128 caracteres e seguir o padrão [A-Za-z_][A-Za-z0-9_]* (por exemplo, API_KEY ou _INTERNAL).
O valor deve ser uma string de até 4096 caracteres. Para representar um valor vazio, envie ""; números e booleanos devem ser convertidos para strings.
Não é possível alterar variáveis enquanto o app está em BUILDING; a API responde com 400 Bad Request.
As respostas de escrita incluem success: true, response com o mapa atualizado de variáveis e a mensagem Environment variables saved. Restart the app to apply changes.. Falhas retornam success: false e message, com o status HTTP correspondente. Trate response como dado secreto.

Aplicar as alterações

Depois de salvar as variáveis, reinicie a aplicação:

await sonder.apps.restart(appId);

O start e o restart usam o conjunto de variáveis salvo. Para uma aplicação parada, sonder.apps.start(appId) também inicia o container com os valores atuais.

Comece aqui

Aplicações

Databases

Conta

Tratamento de Erros

Operações

Consultar

Adicionar ou atualizar

Substituir o conjunto completo

Remover chaves

Formato e limites

Aplicar as alterações

​Operações

​Consultar

​Adicionar ou atualizar

​Substituir o conjunto completo

​Remover chaves

​Formato e limites

​Aplicar as alterações

Operações

Consultar

Adicionar ou atualizar

Substituir o conjunto completo

Remover chaves

Formato e limites

Aplicar as alterações