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

# Añadir base de datos al stack

> Crea una base de datos ya dentro de un stack y la conecta a las aplicaciones que elijas.

Crea una base de datos dentro del stack y la conecta a las aplicaciones que listes. La base de datos cuenta contra tu plan como cualquier otra, con los mismos límites que [Crear base de datos](https://docs.vertracloud.app/es-es/api-reference/endpoint/databases/create.md). Requiere el scope `stacks:write` cuando se llama con una clave de API.

El mismo cuerpo funciona en `POST https://api.vertracloud.app/v1/apps/{id}/stack/databases`, que parte de una aplicación. Cuando esa aplicación **no está en un stack**, la llamada también crea el stack, con el nombre que indiques en `stack_name`.

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

El ID del stack. En `/v1/apps/{id}/stack/databases`, la ruta lleva en su lugar el ID de la aplicación.

**workspace\_id** `string`

El workspace al que pertenece el stack, cuando actúas sobre él como propietario del workspace.

**type** `string` *required*

El motor de la base de datos.

**name** `string` *required*

El nombre de la base de datos.

**ram** `integer` *required*

Memoria en MB.

**version** `string`

La versión del motor.

**description** `string | null`

Descripción opcional.

**bindings** `object[]`

Las aplicaciones a las que conectarla. Cada elemento tiene `app_id` y un `env_map` opcional (consulta [Crear conexión del stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/bindings/create.md)).

**stack\_name** `string`

Solo para `POST /v1/apps/{id}/stack/databases` sobre una aplicación que no está en un stack: el nombre del stack que se crea.

### Response

**response** `object`

`201`.

**Mostrar objeto**

**stack** `object`

El stack, como en [Obtener stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/get.md).

**database\_id** `string`

El ID de la nueva base de datos.

**restart\_required** `boolean`

`true` cuando una aplicación debe reiniciarse para leer las nuevas variables y certificados.

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

Las aplicaciones que necesitan un reinicio.

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 403 | `MAX_DATABASES_REACHED` | Se alcanzó el límite de bases de datos del plan. |
| 403 | `INSUFFICIENT_MEMORY` | No hay memoria libre suficiente en el plan para la base de datos. |
| 400 | `INVALID_DATABASE_VERSION` | La versión no existe para el motor. |
| 409 | `STACK_MEMBER_CONFLICT` | La aplicación ya está en otro stack. |
| 403 | `WORKSPACE_OWNER_ONLY` | Eres miembro del workspace, no su propietario. |
| 404 | `STACK_NOT_FOUND` | El stack no existe o pertenece a otra cuenta. |


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