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" }
}'
Conexiones
Crear conexión del stack
Conecta una aplicación de un stack a una base de datos, una carpeta de Blob o otra aplicación, inyectando variables gestionadas.
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 una aplicación del stack a una base de datos, a una carpeta de Blob o a otra aplicación del stack. La plataforma escribe las variables en la aplicación y, en el caso de una base de datos, los certificados de cliente en
/app/.vertra/certs/<database_id>/. El modo de red es public: la aplicación llega a la dirección pública de la base de datos con un certificado de cliente. Requiere el scope stacks:write cuando se llama con una clave de API.
string
requerido
El ID del stack.
string
El workspace al que pertenece el stack, cuando actúas sobre él como propietario del workspace.
string
requerido
La aplicación del stack que recibe las variables.
string
La base de datos a la que conectarse. Envía exactamente uno de
database_id, blob_id y target_app_id.string
El ID del miembro Blob al que conectarse.
string
Otra aplicación del stack a la que conectarse.
object
Nombres de variables y lo que recibe cada una. Sin este campo, la plataforma usa los nombres estándar del motor (
DATABASE_URL, MONGODB_URI, REDIS_URL, MYSQL_URL), con el nombre del servicio como prefijo en la segunda conexión de un mismo motor. Valores permitidos:- Base de datos:
url,host,port,user,password,database,ssl.ca_path,ssl.cert_path,ssl.key_path,ssl.pem_path(clave, certificado y CA en un solo archivo, el formato que lee MongoDB),ssl.p12_path(PKCS#12 con contraseña vacía, el formato que leen Prisma 6 y versiones anteriores) yprisma_url(una URL de PostgreSQL para Prisma 6 y versiones anteriores; nunca se añade por defecto). - Otra aplicación (o la propia aplicación):
urlydomain(solo el nombre del host, sin el esquema). Los dos siguen el cambio de subdominio o de dominio. - Carpeta de Blob:
endpoint,bucket,region,prefix,access_key_id,secret_access_keyypublic_base_url(vacío cuando la carpeta es privada).
Response
201 con la conexión (los mismos campos que Listar conexiones del stack) más restart_required y apps_to_restart. Una aplicación lee las variables y los certificados solo al arrancar, así que reinicia las aplicaciones listadas en 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" }
}'
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | VALIDATION_ERROR | No hay exactamente un destino, o un valor de env_map no es válido para el destino. |
| 400 | FORBIDDEN_KEY | Un nombre de variable está reservado por la plataforma. |
| 409 | ENV_DUPLICATE_KEY | Un nombre de variable ya lo gestiona otra conexión. |
| 403 | WORKSPACE_OWNER_ONLY | Eres miembro del workspace, no su propietario. |
| 404 | STACK_NOT_FOUND | El stack no existe o pertenece a otra cuenta. |
| 404 | STACK_MEMBER_NOT_FOUND | La aplicación o el destino no es miembro del stack. |
Última modificación el 30 de octubre de 2026