> ## 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 pasta do Blob à stack

> Adiciona uma pasta do seu Blob Storage a uma stack, com uma chave gerenciada restrita a ela e variáveis injetadas nas suas aplicações.

Adiciona uma pasta do seu [Blob Storage](https://docs.vertracloud.app/pt-br/blob/overview.md) à stack. A plataforma cria uma chave de API **restrita a essa pasta**, mantém essa chave na stack e injeta as variáveis de conexão S3 nos apps que você escolher. A chave é gerenciada pela plataforma: ela nunca mostra o segredo, e é revogada quando a pasta do Blob sai da stack ou quando a stack é desfeita ou apagada. Os arquivos são mantidos, a menos que você peça para apagá-los (veja [Remover membro da stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/members/remove.md) e [Excluir stack](https://docs.vertracloud.app/pt-br/api-reference/endpoint/stacks/delete.md)).

O plano precisa incluir o Blob Storage. Precisa dos escopos `stacks:write` e `blob:write` quando chamado com uma chave de API.

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

O ID da stack.

**workspace\_id** `string`

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

**prefix** `string`

A pasta do Blob, terminando em `/`. Sem ela, a plataforma escolhe uma pasta com o nome da stack, dentro de `stacks/`. Não pode ser escolhida uma pasta com arquivos seus, nem uma que já esteja em uso por uma stack.

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

`private` ou `public`.

**bindings** `object[]`

Os apps aos quais conectar a pasta. 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)).

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

**blob** `object`

O novo membro, com `blob.prefix`, `blob.visibility`, `blob.used_bytes` e `blob.api_key_id`.

**restart\_required** `boolean`

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

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

Os apps que precisam reiniciar.

### Erros

| Status | Código | Quando |
| - | - | - |
| 409 | `STACK_BLOB_PREFIX_TAKEN` | A pasta já é usada por uma pasta do Blob de uma stack, ou tem arquivos. |
| 400 | `VALIDATION_ERROR` | O prefixo não é válido. |
| 403 | `BLOB_NAMESPACE_SUSPENDED` | O Blob Storage está suspenso para a conta. |
| 403 | `PLAN_RESTRICTED_FEATURE` | O plano não inclui o Blob Storage. |
| 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.