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

# Excluir stack

> Desfaz uma stack e mantém os membros, ou exclui a stack junto com todos os membros e, opcionalmente, os arquivos do Blob.

Escolha entre dois modos. **`dissolve`** remove só a stack: os apps e bancos de dados ficam como recursos avulsos, sem as variáveis e os certificados gerenciados, e os arquivos do Blob são mantidos. **`delete_all`** apaga também todos os membros, cada um pela sua regra de exclusão (com o snapshot de segurança onde houver um). Em ambos os casos, a chave de API que a plataforma criou para a pasta do Blob da stack é revogada.

> [!WARNING]
>
> `delete_all` não pode ser desfeito e apaga apps e bancos de dados. Confirme o nome e confira os membros antes, com [Obter stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/get.md).

Precisa do escopo `stacks:delete` quando chamado com uma chave de API. Com `delete_all`, a chave também precisa de `apps:delete` e `databases:delete`, e de `blob:write` quando você apaga os arquivos do Blob (`blob: "delete"`). Sem eles, a chamada falha com `API_KEY_SCOPE_DENIED`.

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

**mode** `string` *required*

`dissolve` ou `delete_all`.

**confirm\_name** `string` *required*

Deve ser igual ao nome da stack.

**blob** `string` (default: keep)

O que fazer com os arquivos da pasta do Blob da stack quando `mode` é `delete_all`: `keep` os deixa onde estão, `delete` os remove. `dissolve` sempre os mantém.

### Resposta

**response** `object`

**Mostrar objeto**

**deleted\_apps** `string[]`

IDs dos apps apagados. Vazio com `dissolve`.

**deleted\_databases** `string[]`

IDs dos bancos de dados apagados. Vazio com `dissolve`.

**deleted\_blob** `boolean`

`true` quando os arquivos da pasta do Blob foram apagados.

```json Response theme={null}
{
  "response": {
    "deleted_apps": ["app-abc123def456"],
    "deleted_databases": ["db-abc123def456"],
    "deleted_blob": false
  }
}
```

```bash cURL theme={null}
curl -X DELETE https://api.vertracloud.app/v1/stacks/stk-abc123def456 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "delete_all", "confirm_name": "shop", "blob": "keep" }'
```

### Erros

| Status | Código | Quando |
| - | - | - |
| 400 | `STACK_NAME_MISMATCH` | `confirm_name` não é o nome da stack. |
| 403 | `API_KEY_SCOPE_DENIED` | A chave não tem `stacks:delete`, ou, com `delete_all`, não tem `apps:delete`, `databases:delete` ou `blob:write`; `details.required` indica o escopo. |
| 403 | `WORKSPACE_OWNER_ONLY` | Você é membro do workspace, não o dono. |
| 403 | `STACK_SERVICE_LOCKED` | `dissolve` numa stack com aplicação de template fechado, que não pode sair da stack. Use `delete_all`. |
| 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.