> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sondercloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

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

> [!WARNING]
>
> As respostas mostram os valores sem mascaramento. Proteja-as como dados secretos.

## Consultar

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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`.

```bash theme={null}
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](https://docs.sondercloud.app/api-reference/endpoint/apps/envs-list.md), [adicionar/atualizar](https://docs.sondercloud.app/api-reference/endpoint/apps/envs-add-update.md), [mesclar](https://docs.sondercloud.app/api-reference/endpoint/apps/envs-merge.md), [substituir](https://docs.sondercloud.app/api-reference/endpoint/apps/envs-overwrite.md) e [remover](https://docs.sondercloud.app/api-reference/endpoint/apps/envs-remove.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.