curl https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN
{
"response": {
"mode": "use",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"icon_url": null,
"author_display": "Ana",
"version": "1.0.0",
"services": [
{ "id": "bot", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "none", "conditional": false }
],
"creates_stack": false,
"ram_min_total": 256,
"required_plan": "economy",
"image_slots_needed": 0,
"verified": false,
"code_view": true,
"byok": false,
"inputs": [],
"permissions": {
"code_view": true,
"code_edit": true,
"ram_change": true,
"ram_below_min": false,
"ram_above_max": true,
"env_add": true,
"commands_edit": true,
"terminal": false,
"save_as_template": false,
"detach": true
}
}
}
Enlaces para compartir
Previsualizar un enlace para compartir plantilla
Muestra lo que daría un enlace para compartir una plantilla antes de usarlo: servicios, memoria, plan, preguntas y permisos, con el aviso de no verificada.
GET
/
v1
/
share
/
templates
/
{token}
curl https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN
{
"response": {
"mode": "use",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"icon_url": null,
"author_display": "Ana",
"version": "1.0.0",
"services": [
{ "id": "bot", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "none", "conditional": false }
],
"creates_stack": false,
"ram_min_total": 256,
"required_plan": "economy",
"image_slots_needed": 0,
"verified": false,
"code_view": true,
"byok": false,
"inputs": [],
"permissions": {
"code_view": true,
"code_edit": true,
"ram_change": true,
"ram_below_min": false,
"ram_above_max": true,
"env_add": true,
"commands_edit": true,
"terminal": false,
"save_as_template": false,
"detach": true
}
}
}
Esta llamada devuelve lo que crearía un enlace para compartir, para que una persona pueda decidir antes de usarlo. Funciona sin autenticación; cuando estás autenticado, la respuesta también trae un objeto
account que indica si la plantilla encaja en tu cuenta. Está limitada por IP (20 peticiones por minuto).
La vista previa nunca muestra IDs, correos electrónicos, el manifiesto ni el código fuente. verified siempre es false: Vertra Cloud no revisa las plantillas privadas, y el panel muestra “No verificado por Vertra” junto a cada una. Revisa el autor y lo que hace la plantilla antes de usarla. En una plantilla cerrada (code_view es false) no puedes ver el código, y los valores que rellenas van a un código que no puedes leer. Si algo parece mal, reporta la plantilla.
Una clave de API necesita el ámbito templates:read cuando se envía.
string
requerido
El token del enlace, que empieza por
vtpl_.curl https://api.vertracloud.app/v1/share/templates/vtpl_EXAMPLE_TOKEN
Respuesta
object
La vista previa.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
use (creas tus propias aplicaciones desde ella) o full_copy (obtienes una plantilla privada propia).object
El nombre de la plantilla por idioma (
pt-br, en, es).object
La descripción por idioma.
string
La categoría.
string | null
URL del icono, o
null.string | null
El nombre que el autor eligió mostrar.
string
La versión que da el enlace.
object[]
Lo que se crearía. Cada servicio tiene
id, kind (app, database o blob), source_type, database, blob_visibility, ram (min, recommended y max opcional, en MB), web y conditional.boolean
true cuando crea un stack.integer
La suma de la memoria mínima de los servicios, en MB.
string
El plan más bajo que puede usarla.
integer
Los slots de imagen personalizados que usarías: uno por cada imagen distinta de la plantilla, así que puede ser más de 1. Una plantilla solo con código no usa ninguno.
boolean
Siempre
false.boolean
false para una plantilla cerrada.boolean
true cuando traes tu propia clave para un modelo de IA.object[]
Las preguntas que respondes al usarla.
object
Lo que puedes hacer con las aplicaciones creadas desde ella:
code_view, code_edit, ram_change, ram_below_min, ram_above_max, env_add, commands_edit, terminal, save_as_template y detach.object
Solo cuando estás autenticado:
fits, reasons, required_ram, free_ram, needs_image_slot, image_slots_free, in_use e in_use_count.{
"response": {
"mode": "use",
"name": { "pt-br": "Bot de suporte", "en": "Support bot" },
"description": { "pt-br": "Bot que responde o suporte." },
"category": "bots",
"icon_url": null,
"author_display": "Ana",
"version": "1.0.0",
"services": [
{ "id": "bot", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 512 }, "web": "none", "conditional": false }
],
"creates_stack": false,
"ram_min_total": 256,
"required_plan": "economy",
"image_slots_needed": 0,
"verified": false,
"code_view": true,
"byok": false,
"inputs": [],
"permissions": {
"code_view": true,
"code_edit": true,
"ram_change": true,
"ram_below_min": false,
"ram_above_max": true,
"env_add": true,
"commands_edit": true,
"terminal": false,
"save_as_template": false,
"detach": true
}
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
SHARE_LINK_NOT_FOUND: El token tiene un formato no válido, no existe, o su plantilla fue eliminada (404).SHARE_LINK_REVOKED: El autor revocó el enlace (410).SHARE_LINK_EXPIRED: El enlace superó suexpires_at(410).SHARE_LINK_EXHAUSTED: El enlace alcanzó sumax_uses(410).API_KEY_SCOPE_DENIED: Se envió una clave de API sin el ámbitotemplates:read(403).
{
"code": "SHARE_LINK_EXPIRED"
}
Última modificación el 28 de octubre de 2026