> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/api-and-integrations/api-overview/variaveis-de-ambiente.md).

# Variáveis de ambiente

## Listar variáveis da conta

> Retorna todas as variáveis de ambiente do escopo de conta (descriptografadas).

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/account":{"get":{"tags":["Variáveis de Ambiente"],"summary":"Listar variáveis da conta","description":"Retorna todas as variáveis de ambiente do escopo de conta (descriptografadas).","operationId":"getAccountEnvVars","responses":{"200":{"description":"Variáveis retornadas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Substituir variáveis da conta

> Substitui todo o conjunto de variáveis de ambiente do escopo de conta.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/account":{"put":{"tags":["Variáveis de Ambiente"],"summary":"Substituir variáveis da conta","description":"Substitui todo o conjunto de variáveis de ambiente do escopo de conta.","operationId":"setAccountEnvVars","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vars"],"properties":{"vars":{"type":"object","additionalProperties":{"type":"string"},"description":"Mapa chave/valor com as variáveis"}}}}}},"responses":{"200":{"description":"Variáveis salvas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Variáveis inválidas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Remover variáveis da conta

> Remove todas as variáveis de ambiente do escopo de conta.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/account":{"delete":{"tags":["Variáveis de Ambiente"],"summary":"Remover variáveis da conta","description":"Remove todas as variáveis de ambiente do escopo de conta.","operationId":"deleteAccountEnvVars","responses":{"200":{"description":"Variáveis removidas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Listar variáveis do projeto

> Retorna as variáveis de ambiente de um projeto (descriptografadas). Requer permissão de gerenciamento do projeto.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/project/{projectID}":{"get":{"tags":["Variáveis de Ambiente"],"summary":"Listar variáveis do projeto","description":"Retorna as variáveis de ambiente de um projeto (descriptografadas). Requer permissão de gerenciamento do projeto.","operationId":"getProjectEnvVars","parameters":[{"name":"projectID","in":"path","required":true,"description":"ID do projeto","schema":{"type":"string"}}],"responses":{"200":{"description":"Variáveis retornadas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para acessar o projeto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Projeto não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Substituir variáveis do projeto

> Substitui todo o conjunto de variáveis de ambiente de um projeto.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/project/{projectID}":{"put":{"tags":["Variáveis de Ambiente"],"summary":"Substituir variáveis do projeto","description":"Substitui todo o conjunto de variáveis de ambiente de um projeto.","operationId":"setProjectEnvVars","parameters":[{"name":"projectID","in":"path","required":true,"description":"ID do projeto","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vars"],"properties":{"vars":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"responses":{"200":{"description":"Variáveis salvas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Variáveis inválidas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar o projeto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Projeto não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Remover variáveis do projeto

> Remove todas as variáveis de ambiente de um projeto.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/project/{projectID}":{"delete":{"tags":["Variáveis de Ambiente"],"summary":"Remover variáveis do projeto","description":"Remove todas as variáveis de ambiente de um projeto.","operationId":"deleteProjectEnvVars","parameters":[{"name":"projectID","in":"path","required":true,"description":"ID do projeto","schema":{"type":"string"}}],"responses":{"200":{"description":"Variáveis removidas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar o projeto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Projeto não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Listar variáveis do app

> Retorna as variáveis de ambiente de um app (descriptografadas). Requer permissão config\_app.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/app/{appID}":{"get":{"tags":["Variáveis de Ambiente"],"summary":"Listar variáveis do app","description":"Retorna as variáveis de ambiente de um app (descriptografadas). Requer permissão config_app.","operationId":"getAppEnvVars","parameters":[{"name":"appID","in":"path","required":true,"description":"ID da aplicação","schema":{"type":"string"}}],"responses":{"200":{"description":"Variáveis retornadas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para acessar o app","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Aplicação não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Substituir variáveis do app

> Substitui todo o conjunto de variáveis de ambiente de um app.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/app/{appID}":{"put":{"tags":["Variáveis de Ambiente"],"summary":"Substituir variáveis do app","description":"Substitui todo o conjunto de variáveis de ambiente de um app.","operationId":"setAppEnvVars","parameters":[{"name":"appID","in":"path","required":true,"description":"ID da aplicação","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vars"],"properties":{"vars":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"responses":{"200":{"description":"Variáveis salvas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Variáveis inválidas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar o app","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Aplicação não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Remover variáveis do app

> Remove todas as variáveis de ambiente de um app.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Variáveis de Ambiente","description":"Operações sobre variáveis de ambiente (conta, projeto e app)"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/env/app/{appID}":{"delete":{"tags":["Variáveis de Ambiente"],"summary":"Remover variáveis do app","description":"Remove todas as variáveis de ambiente de um app.","operationId":"deleteAppEnvVars","parameters":[{"name":"appID","in":"path","required":true,"description":"ID da aplicação","schema":{"type":"string"}}],"responses":{"200":{"description":"Variáveis removidas com sucesso","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Sem permissão para gerenciar o app","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Aplicação não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```