> ## 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 carpeta de Blob al stack

> Añade una carpeta de tu Blob Storage a un stack, con una clave gestionada restringida a ella y variables inyectadas en tus aplicaciones.

Añade una carpeta de tu [Blob Storage](https://docs.vertracloud.app/es-es/blob/overview.md) al stack. La plataforma crea una clave de API **restringida a esa carpeta**, la mantiene en el stack e inyecta las variables de conexión S3 en las aplicaciones que elijas. La clave la gestiona la plataforma: nunca muestra su secreto, y se revoca cuando la carpeta de Blob sale del stack o cuando el stack se disuelve o se elimina. Los archivos se conservan salvo que pidas borrarlos (consulta [Eliminar miembro del stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/members/remove.md) y [Eliminar stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/delete.md)).

El plan debe incluir Blob Storage. Requiere los scopes `stacks:write` y `blob:write` cuando se llama con una clave de API.

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

El ID del stack.

**workspace\_id** `string`

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

**prefix** `string`

La carpeta del Blob, terminada en `/`. Si no se indica, la plataforma elige una carpeta con el nombre del stack, dentro de `stacks/`. No se puede elegir una carpeta con archivos tuyos, ni una que ya use la carpeta de Blob de otro stack.

**visibility** `string` (default: private)

`private` o `public`.

**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)).

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

**blob** `object`

El nuevo miembro, con `blob.prefix`, `blob.visibility`, `blob.used_bytes` y `blob.api_key_id`.

**restart\_required** `boolean`

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

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

Las aplicaciones que necesitan un reinicio.

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 409 | `STACK_BLOB_PREFIX_TAKEN` | La carpeta ya la usa una carpeta de Blob de un stack, o tiene archivos. |
| 400 | `VALIDATION_ERROR` | El prefijo no es válido. |
| 403 | `BLOB_NAMESPACE_SUSPENDED` | Blob Storage está suspendido para la cuenta. |
| 403 | `PLAN_RESTRICTED_FEATURE` | El plan no incluye Blob Storage. |
| 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.