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" }'
{
"response": {
"deleted_apps": ["app-abc123def456"],
"deleted_databases": ["db-abc123def456"],
"deleted_blob": false
}
}
Stacks
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.
DELETE
/
v1
/
stacks
/
{stack_id}
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" }'
{
"response": {
"deleted_apps": ["app-abc123def456"],
"deleted_databases": ["db-abc123def456"],
"deleted_blob": false
}
}
Escolha entre dois modos.
Precisa do escopo
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.
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.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.
string
obrigatório
O ID da stack.
string
O workspace ao qual a stack pertence, quando você age sobre ela como dono do workspace.
string
obrigatório
dissolve ou delete_all.string
obrigatório
Deve ser igual ao nome da stack.
string
padrão:"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
object
{
"response": {
"deleted_apps": ["app-abc123def456"],
"deleted_databases": ["db-abc123def456"],
"deleted_blob": false
}
}
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. |
Última modificação em 30 de outubro de 2026