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

# Listar variáveis de ambiente

> Leia as variáveis de ambiente de uma aplicação como um objeto chave-valor com GET /v2/apps/{app_id}/envs. Retorna um objeto vazio quando não há nenhuma.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `envs:read`.

Retorna as variáveis de ambiente atuais da aplicação como um objeto plano de chave-valor, lido diretamente do arquivo `.env` no cluster. Se nenhuma variável tiver sido definida ainda, a resposta é um sucesso com um objeto vazio, em vez de um erro.

Aplicações estáticas não suportam variáveis de ambiente e retornam um erro. Em aplicações compartilhadas em workspace, quem chama precisa da [função](/pt-br/api-reference/endpoint/workspace/members/invite#funções) `admin` ou ser o proprietário.

Para adicionar ou atualizar variáveis, use [Adicionar/editar variáveis](/pt-br/api-reference/endpoint/apps/envs/add_n_edit); para substituir todo o conjunto, veja [Sobrescrever variáveis](/pt-br/api-reference/endpoint/apps/envs/overwrite).

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  As chaves e valores de todas as variáveis de ambiente que você definiu.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success",
    "response": {
      "TEST": "myTest"
    }
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `STATIC_APP_ENV_NOT_SUPPORTED` | 400 | A aplicação é estática; aplicações estáticas não suportam variáveis de ambiente. |
| `READ_FAILED` | 400 | Não foi possível ler o arquivo `.env` no cluster. |

## Relacionados

* CLI: [`squarecloud app env list`](/pt-br/cli-reference/environment-variables#squarecloud-app-env-list)
* SDKs: [`api.apps.envs.get()`](/pt-br/sdks/js/environment_variables) (JavaScript), [`client.apps.envs.get()`](/pt-br/sdks/py/environment_variables) (Python), [`c.Apps.Envs.Get()`](/pt-br/sdks/go/environment_variables) (Go)


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