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
Eliminar stack
Disuelve un stack y conserva sus miembros, o elimina el stack junto con todos sus miembros y, opcionalmente, sus archivos de 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
}
}
Elige entre dos modos.
Requiere el scope
dissolve elimina solo el stack: las aplicaciones y las bases de datos quedan como recursos sueltos, sin las variables ni los certificados gestionados, y los archivos de Blob se conservan. delete_all elimina también a todos los miembros, cada uno según su propia regla de eliminación (con la snapshot de seguridad cuando existe). En ambos casos se revoca la clave de API que creó la plataforma para la carpeta de Blob del stack.
delete_all no se puede deshacer y elimina aplicaciones y bases de datos. Confirma el nombre y revisa antes los miembros con Obtener stack.stacks:delete cuando se llama con una clave de API. Con delete_all, la clave también necesita apps:delete y databases:delete, y blob:write cuando eliminas los archivos de Blob (blob: "delete"). Sin ellos, la llamada falla con API_KEY_SCOPE_DENIED.
string
requerido
El ID del stack.
string
El workspace al que pertenece el stack, cuando actúas sobre él como propietario del workspace.
string
requerido
dissolve o delete_all.string
requerido
Debe ser igual al nombre del stack.
string
predeterminado:"keep"
Qué hacer con los archivos de la carpeta de Blob del stack cuando
mode es delete_all: keep los deja donde están, delete los elimina. dissolve siempre los conserva.Response
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" }'
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | STACK_NAME_MISMATCH | confirm_name no es el nombre del stack. |
| 403 | API_KEY_SCOPE_DENIED | La clave no tiene stacks:delete, o con delete_all no tiene apps:delete, databases:delete o blob:write; details.required indica el scope que falta. |
| 403 | WORKSPACE_OWNER_ONLY | Eres miembro del workspace, no su propietario. |
| 403 | STACK_SERVICE_LOCKED | dissolve en un stack con una aplicación de plantilla cerrada, que no puede salir del stack. Usa delete_all. |
| 404 | STACK_NOT_FOUND | El stack no existe o pertenece a otra cuenta. |
Última modificación el 30 de octubre de 2026