curl -X POST https://api.vertracloud.app/v1/stacks/stk-abc123def456/bindings \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"env_map": { "DATABASE_URL": "url" }
}'
Conexões
Criar conexão da stack
Conecta um app de uma stack a um banco de dados, a uma pasta do Blob ou a outro app, injetando variáveis gerenciadas.
POST
/
v1
/
stacks
/
{stack_id}
/
bindings
curl -X POST https://api.vertracloud.app/v1/stacks/stk-abc123def456/bindings \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"env_map": { "DATABASE_URL": "url" }
}'
Conecta um app da stack a um banco de dados, a uma pasta do Blob ou a outro app da stack. A plataforma grava as variáveis no app e, no caso de um banco de dados, os certificados de cliente em
/app/.vertra/certs/<database_id>/. O modo de rede é public: o app alcança o endereço público do banco com um certificado de cliente. Precisa do escopo stacks:write quando chamado com uma chave de API.
string
obrigatório
O ID da stack.
string
O workspace ao qual a stack pertence, quando você age sobre ela como dono do workspace.
string
obrigatório
O app da stack que recebe as variáveis.
string
O banco de dados ao qual conectar. Envie exatamente um entre
database_id, blob_id e target_app_id.string
O ID do membro Blob ao qual conectar.
string
Outro app da stack ao qual conectar.
object
Nomes das variáveis e o que cada uma recebe. Sem ele, a plataforma usa os nomes padrão do engine (
DATABASE_URL, MONGODB_URI, REDIS_URL, MYSQL_URL), prefixados com o nome do serviço a partir da segunda conexão de um mesmo engine. Valores permitidos:- Banco de dados:
url,host,port,user,password,database,ssl.ca_path,ssl.cert_path,ssl.key_path,ssl.pem_path(chave, certificado e CA em um só arquivo, o formato que o MongoDB lê),ssl.p12_path(PKCS#12 com senha vazia, o formato que o Prisma 6 e versões anteriores leem) eprisma_url(uma URL do PostgreSQL para o Prisma 6 e versões anteriores; nunca é adicionada por padrão). - Outro app (ou o próprio app):
urledomain(só o nome do host, sem o esquema). Os dois acompanham a troca de subdomínio ou de domínio. - Pasta do Blob:
endpoint,bucket,region,prefix,access_key_id,secret_access_keyepublic_base_url(vazio quando a pasta é privada).
Resposta
201 com a conexão (os mesmos campos de Listar conexões da stack) mais restart_required e apps_to_restart. Um app lê variáveis e certificados só quando inicia, então reinicie os apps listados em apps_to_restart.
curl -X POST https://api.vertracloud.app/v1/stacks/stk-abc123def456/bindings \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"env_map": { "DATABASE_URL": "url" }
}'
Erros
| Status | Código | Quando |
|---|---|---|
| 400 | VALIDATION_ERROR | Não há exatamente um alvo, ou um valor em env_map não é válido para o alvo. |
| 400 | FORBIDDEN_KEY | Um nome de variável é reservado pela plataforma. |
| 409 | ENV_DUPLICATE_KEY | Um nome de variável já é gerenciado por outra conexão. |
| 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_MEMBER_NOT_FOUND | O app ou o alvo não é membro da stack. |
Última modificação em 30 de outubro de 2026