> ## 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 conexão da stack

> Remove uma conexão de uma stack, mantendo ou apagando as variáveis que ela criou.

Remove uma conexão. Os membros continuam na stack. Precisa do escopo `stacks:write` quando chamado com uma chave de API.

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

O ID da stack.

**binding\_id** `string` *required*

O ID da conexão.

**variables** `string` (default: keep\_connection)

O que acontece com as variáveis que a conexão criou:

* `keep_connection`: elas viram variáveis comuns e os certificados ficam, então o app continua conectando.
* `remove_variables`: as variáveis e os certificados copiados para o app são apagados.

**workspace\_id** `string`

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

### Resposta

**response** `object`

**Mostrar objeto**

**restart\_required** `boolean`

`true` quando variáveis foram removidas de um app (`variables=remove_variables`): ele precisa reiniciar para deixar de lê-las.

**apps\_to\_restart** `string[]`

Os apps que precisam reiniciar.

```json Response theme={null}
{
  "response": { "restart_required": true, "apps_to_restart": ["app-abc123def456"] }
}
```

### Erros

| Status | Código | Quando |
| - | - | - |
| 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. |
| 404 | `STACK_BINDING_NOT_FOUND` | A stack não tem uma conexão com esse ID. |


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