Variáveis de Ambiente

Consultar e alterar as variáveis de uma aplicação

Use /v1/apps/:id/envs para gerenciar as variáveis de uma aplicação. As alterações são salvas, mas só entram em vigor depois de reiniciar a aplicação.

As respostas mostram os valores sem mascaramento. Proteja-as como dados secretos.

Consultar

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

Adicionar ou atualizar

POST e PATCH alteram as chaves enviadas. As outras permanecem iguais.

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

Substituir todas

PUT troca o conjunto inteiro. Chaves omitidas são removidas; {"envs":{}} apaga todas.

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 algumas

DELETE remove as chaves do array keys.

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"]}'

Os valores devem ser strings. São aceitas até 256 variáveis por aplicação; os nomes seguem o padrão [A-Za-z_][A-Za-z0-9_]*, com até 128 caracteres. Não é possível alterar variáveis durante um BUILDING.

Para mais detalhes, veja listar, adicionar/atualizar, mesclar, substituir e remover.