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

# Substituir todas as variáveis de ambiente

> Substitua todo o ambiente de uma aplicação com PUT /v2/apps/{app_id}/envs: variáveis fora do corpo são excluídas, e um objeto envs vazio apaga todas.

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

Sobrescrever substitui todo o ambiente da aplicação exatamente pelas variáveis enviadas: tudo que já estava definido e não foi incluído no corpo da requisição é excluído. Enviar um objeto `envs` vazio apaga todas as variáveis, o que torna este o endpoint indicado para uma redefinição completa, em vez de uma alteração incremental.

Aplicam-se os mesmos limites dos demais endpoints de variáveis de ambiente: até 256 variáveis por aplicação, 1024 caracteres por chave, 4096 por valor. Aplicações estáticas não são suportadas e retornam um erro, e 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.

Se você precisa apenas alterar algumas variáveis sem afetar as demais, use [Adicionar/editar variáveis](/pt-br/api-reference/endpoint/apps/envs/add_n_edit), ou [Remover variáveis](/pt-br/api-reference/endpoint/apps/envs/remove) para excluir chaves específicas.

## 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">
  As chaves e valores das variáveis que você deseja no 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": "overwriteTest"
    }
  }
  ```
</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 novo conjunto 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 replace`](/pt-br/cli-reference/environment-variables#squarecloud-app-env-replace)
* SDKs: [`api.apps.envs.replace()`](/pt-br/sdks/js/environment_variables) (JavaScript), [`client.apps.envs.replace()`](/pt-br/sdks/py/environment_variables) (Python), [`c.Apps.Envs.Replace()`](/pt-br/sdks/go/environment_variables) (Go)


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