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

# Atualizar configuração de build

> Atualiza alocação e limites de recursos da aplicação.

Atualiza alocação e limites de recursos da aplicação. Envie os valores atuais para configurações que deseja preservar. A API transmite defaults para campos opcionais omitidos.

## Parâmetros

**appId** `string` *required*

ID da aplicação, obtido no painel ou em `response.applications[].id` ao [consultar a conta](https://docs.dscloud.pt/api-reference/endpoint/users/me.md).

**allocation** `object` *required*

`memory` (MB) é obrigatório e deve ser um número finito maior ou igual a zero. Defaults numéricos: `swap` 0, `io` 500 e `cpu` 100.

**feature\_limits** `object`

`databases`, `allocations` e `backups` são numéricos e têm default 0.

## Resposta

HTTP 200. `response` é um objeto. Seus campos também podem aparecer no nível superior por compatibilidade.

```json HTTP 200 theme={null}
{
  "status": "success",
  "code": "SUCCESS",
  "response": {
    "message": "Build settings updated successfully",
    "identifier": "a1b2c3d4"
  },
  "message": "Build settings updated successfully",
  "identifier": "a1b2c3d4",
  "success": true
}
```

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 400 | `INVALID_MEMORY` | `allocation.memory` inválido. |
| 500 | `BUILD_UPDATE_FAILED` | Falha ao atualizar a configuração. |

```bash cURL theme={null}
: "${DSCLOUD_API_BASE_URL:=https://api.dscloud.pt/v3}"
curl --proto '=https' --fail-with-body --request PATCH \
  --header "Authorization: ${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"allocation":{"memory":256,"swap":0,"io":500,"cpu":100},"feature_limits":{"databases":0,"allocations":0,"backups":0}}' \
  "${DSCLOUD_API_BASE_URL%/}/apps/${DSCLOUD_APP_ID:?Defina DSCLOUD_APP_ID}/build"
```


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