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

# Atualizar stack

> Renomeia uma stack ou altera a descrição dela.

Altera o nome ou a descrição de uma stack. Pelo menos um campo é obrigatório. Precisa do escopo `stacks:write` quando chamado com uma chave de API.

**stack\_id** `string` *required*

O ID da stack.

**workspace\_id** `string`

O workspace ao qual a stack pertence, quando você age sobre ela como dono do workspace.

**name** `string`

O novo nome.

**description** `string | null`

A nova descrição. `null` a remove.

### Resposta

**response** `object`

A stack atualizada, com os mesmos campos de [Obter stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/get.md).

```bash cURL theme={null}
curl -X PATCH https://api.vertracloud.app/v1/stacks/stk-abc123def456 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "shop-prod" }'
```

### Erros

| Status | Código | Quando |
| - | - | - |
| 400 | `VALIDATION_ERROR` | Nenhum campo foi enviado, ou um valor é inválido. |
| 403 | `WORKSPACE_OWNER_ONLY` | Você é membro do workspace, não o dono. |
| 404 | `STACK_NOT_FOUND` | A stack não existe ou pertence a outra conta. |


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