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

# Adicionar banco de dados à stack

> Cria um banco de dados já dentro de uma stack e o conecta aos apps que você escolher.

Cria um banco de dados dentro da stack e o conecta aos apps listados. O banco conta no seu plano como qualquer outro, com os mesmos limites de [Criar banco de dados](https://docs.vertracloud.app/pt-br/api-reference/endpoint/databases/create.md). Precisa do escopo `stacks:write` quando chamado com uma chave de API.

O mesmo corpo funciona em `POST https://api.vertracloud.app/v1/apps/{id}/stack/databases`, que parte de um app. Quando esse app **não está em uma stack**, a chamada também cria a stack, com o nome definido por `stack_name`.

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

O ID da stack. Em `/v1/apps/{id}/stack/databases`, o path traz o ID do app.

**workspace\_id** `string`

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

**type** `string` *required*

O engine do banco de dados.

**name** `string` *required*

O nome do banco de dados.

**ram** `integer` *required*

Memória em MB.

**version** `string`

A versão do engine.

**description** `string | null`

Descrição opcional.

**bindings** `object[]`

Os apps aos quais conectar. Cada item tem `app_id` e um `env_map` opcional (veja [Criar conexão da stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/bindings/create.md)).

**stack\_name** `string`

Somente para `POST /v1/apps/{id}/stack/databases` em um app que não está em uma stack: o nome da stack que será criada.

### Resposta

**response** `object`

`201`.

**Mostrar objeto**

**stack** `object`

A stack, como em [Obter stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/get.md).

**database\_id** `string`

O ID do novo banco de dados.

**restart\_required** `boolean`

`true` quando um app precisa reiniciar para ler as novas variáveis e certificados.

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

Os apps que precisam reiniciar.

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `MAX_DATABASES_REACHED` | O limite de bancos de dados do plano foi atingido. |
| 403 | `INSUFFICIENT_MEMORY` | Não há memória livre suficiente no plano para o banco de dados. |
| 400 | `INVALID_DATABASE_VERSION` | A versão não existe para o engine. |
| 409 | `STACK_MEMBER_CONFLICT` | O app já está em outra stack. |
| 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.