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

# Adicionar ou editar variáveis de ambiente

> Adicione ou atualize variáveis de ambiente com POST /v2/apps/{app_id}/envs. As que ficam fora do corpo não mudam, o que serve para trocar uma única chave.

<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:write`.

Use este endpoint para adicionar novas variáveis de ambiente ou atualizar variáveis específicas sem alterar as demais. Variáveis existentes que não forem incluídas no corpo da requisição permanecem intactas, o que torna esta a opção mais segura para alterações incrementais, como rotacionar uma única chave de API.

Aplicações estáticas não suportam variáveis de ambiente e retornam um erro. O conjunto total é limitado a 256 variáveis por aplicação, com um limite de 1024 caracteres por chave e 4096 caracteres por valor. 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 substituir todo o conjunto de variáveis em vez de mesclar, use [Sobrescrever variáveis](/pt-br/api-reference/endpoint/apps/envs/overwrite). Para remover chaves específicas, veja [Remover variáveis](/pt-br/api-reference/endpoint/apps/envs/remove), e para ler os valores atuais, veja [Listar variáveis](/pt-br/api-reference/endpoint/apps/envs/get).

## Parâmetros

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

<ParamField body="envs" type="object" required>
  A chave e o valor das variáveis de ambiente.
</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. |
| `INVALID_ENV_CONTENT` | 400 | `envs` está ausente, não é um objeto, ou é um array. |
| `TOO_MANY_ENV_VARS` | 400 | O conjunto resultante da mesclagem excederia 256 variáveis de ambiente. |
| `ENV_NAME_TOO_LONG` | 400 | Uma chave de variável excede 1024 caracteres. |
| `ENV_CONTENT_TOO_LONG` | 400 | Um valor de variável excede 4096 caracteres. |

## Relacionados

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


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