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

# Obter variáveis de ambiente da aplicação

> Retorna todas as variáveis de ambiente de uma aplicação pelo seu ID.

**id** `string` *required*

O ID da aplicação cujas variáveis de ambiente serão retornadas.

**workspace\_id** `string`

Se a aplicação pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que atuam em uma aplicação que não é deles.

### Resposta

**response** `array`

Um array de objetos de variável de ambiente.

**Mostrar objeto**

**id** `string`

O ID da variável de ambiente.

**key** `string`

A chave da variável de ambiente.

**value** `string`

O valor da variável de ambiente (descriptografado).

**note** `string | null`

A nota ou descrição opcional da variável de ambiente.

**managed\_by** `object | null`

Definido quando uma conexão de uma [stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/get.md) gerencia a variável: a plataforma
mantém o valor atualizado. Editá-la à mão a transforma em uma variável comum. `null` para uma variável que você possui.

**Propriedades de managed\_by**

**type** `string`

Sempre `stack_binding`.

**binding\_id** `string`

O ID da conexão.

**stack\_id** `string | null`

A stack da conexão, ou `null` para a variável de endereço de uma aplicação que não está em uma stack.

**created\_at** `string`

O timestamp de quando a variável de ambiente foi criada.

```json Response theme={null}
{
  "response": [
    {
      "id": "env-abc123",
      "key": "API_KEY",
      "value": "secret123",
      "note": "API key for external service",
      "created_at": "2026-03-20T19:58:00Z"
    },
    {
      "id": "env-xyz789",
      "key": "DATABASE_URL",
      "value": "mysql://user:pass@database-host/db",
      "note": null,
      "created_at": "2026-03-20T19:58:00Z"
    }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: o cabeçalho `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: a chave de API está sendo usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (`403`).
* `ACCESS_DENIED`: o recurso pertence a outra conta, ou você não tem a permissão do workspace para ele (`403`).
* `FORBIDDEN`: o usuário não tem permissão para acessar a aplicação.
* `APP_NOT_FOUND`: a aplicação especificada não existe.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "APP_NOT_FOUND"
}
```


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