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

# Criar ou editar variáveis de ambiente da aplicação

> Cria ou atualiza as variáveis de ambiente de uma aplicação pelo seu ID.

**id** `string` *required*

O ID da aplicação para a qual as variáveis de ambiente serão criadas ou atualizadas.

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

**environments** `array` *required*

Um array de objetos de variável de ambiente.

**Mostrar objeto**

A chave da variável de ambiente (máximo de 255 caracteres).

O valor da variável de ambiente (máximo de 3.072 caracteres).

Uma nota ou descrição opcional para a variável de ambiente.

### Resposta

**response** `array`

Um array de objetos de variável de ambiente após a criação ou atualização.

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

**created\_at** `string`

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

```json Response theme={null}
{
  "response": [
    {
      "id": "env123",
      "key": "API_KEY",
      "value": "secret123",
      "note": "API key for external service",
      "created_at": "2026-03-14T19:58:00Z"
    },
    {
      "id": "env456",
      "key": "DATABASE_URL",
      "value": "mysql://user:pass@database-host/db",
      "note": null,
      "created_at": "2026-03-14T19: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.
* `INVALID_BODY`: o corpo da requisição não é um array válido ou está vazio.
* `INVALID_ENVIRONMENT`: uma ou mais variáveis de ambiente são inválidas ou usam chaves proibidas.
* `VALIDATION_ERROR`: uma `key` tem mais de 255 caracteres, ou um `value` tem mais de 3.072 caracteres (`400`); `details.path` aponta para o campo.
* `ENV_LIMIT_EXCEEDED`: o número total de variáveis de ambiente ultrapassa o limite de 256.

**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"
}
```

```json Error Response (400) theme={null}
{
  "code": "INVALID_BODY"
}
```


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