curl -X POST https://api.vertracloud.app/v1/templates/validate \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"manifest": {
"id": "my-bot",
"version": "1.0.0",
"name": { "pt-br": "Meu bot" },
"description": { "pt-br": "Um bot de exemplo." },
"category": "bots",
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"ram": { "min": 128, "recommended": 256 },
"web": "none"
}
}
}
}'
{
"response": {
"valid": true,
"issues": [],
"required_plan": "economy",
"ram_min_total": 128,
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 128, "recommended": 256 },
"web": "none",
"conditional": false
}
]
}
}
{
"response": {
"valid": false,
"issues": [
{ "path": "category", "code": "invalid_category", "message": "category must be one of the template categories" },
{ "path": "services.app.env.LD_PRELOAD", "code": "forbidden_env", "message": "This variable is controlled by the platform" }
],
"required_plan": null,
"ram_min_total": null,
"services": []
}
}
Templates
Validar manifesto de template
Verifica um manifesto de template com as regras dos templates privados e devolve os problemas, o plano exigido e a memória necessária, sem criar nada.
POST
/
v1
/
templates
/
validate
curl -X POST https://api.vertracloud.app/v1/templates/validate \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"manifest": {
"id": "my-bot",
"version": "1.0.0",
"name": { "pt-br": "Meu bot" },
"description": { "pt-br": "Um bot de exemplo." },
"category": "bots",
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"ram": { "min": 128, "recommended": 256 },
"web": "none"
}
}
}
}'
{
"response": {
"valid": true,
"issues": [],
"required_plan": "economy",
"ram_min_total": 128,
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 128, "recommended": 256 },
"web": "none",
"conditional": false
}
]
}
}
{
"response": {
"valid": false,
"issues": [
{ "path": "category", "code": "invalid_category", "message": "category must be one of the template categories" },
{ "path": "services.app.env.LD_PRELOAD", "code": "forbidden_env", "message": "This variable is controlled by the platform" }
],
"required_plan": null,
"ram_min_total": null,
"services": []
}
}
Verifica um manifesto e informa todos os problemas que encontra, sem criar nada. A chamada exige autenticação e, com uma chave de API, o escopo
templates:read. Ela sempre responde 200: se o manifesto é válido está no campo valid, então um manifesto que nem é um objeto volta como achados, não como requisição malformada. As verificações são as aplicadas a um template privado. Para os campos do manifesto e exemplos, veja a referência do manifesto e Validar e testar um template.
object | string
obrigatório
O manifesto. Envie como objeto JSON, ou como string com o YAML do arquivo
vertracloud.template.yaml. Uma string que não é YAML válido é reportada como um achado.Resposta
object
O resultado da validação.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
boolean
true quando o manifesto não tem achados.object[]
Os achados. Vazio quando
valid é true.Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O caminho do campo no manifesto, como
services.app.ram.min. Vazio quando o problema é o manifesto como um todo.string
O tipo do achado:
invalid_type, required, unknown_field, invalid_slug, invalid_version, invalid_category, invalid_text, invalid_ram, invalid_plan, unknown_placeholder, unknown_service, unknown_input, invalid_when, invalid_option, invalid_source, invalid_permissions, forbidden_env, forbidden_in_public, secret_in_manifest, invalid_deploy, invalid_connection, duplicate_id ou too_many_services.string
Uma explicação legível, em inglês.
string | null
O plano mais baixo que pode usar o template, calculado a partir do manifesto.
null quando o manifesto não é válido o bastante para calcular.integer | null
A soma da memória mínima de cada serviço, em MB, ou
null.object[]
Os serviços que o manifesto cria, no mesmo formato de Listar templates. Vazio quando o manifesto não é válido.
curl -X POST https://api.vertracloud.app/v1/templates/validate \
-H "Authorization: Bearer $VERTRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"manifest": {
"id": "my-bot",
"version": "1.0.0",
"name": { "pt-br": "Meu bot" },
"description": { "pt-br": "Um bot de exemplo." },
"category": "bots",
"services": {
"app": {
"source": { "type": "code", "path": "src" },
"language": "javascript",
"main": "index.js",
"ram": { "min": 128, "recommended": 256 },
"web": "none"
}
}
}
}'
{
"response": {
"valid": true,
"issues": [],
"required_plan": "economy",
"ram_min_total": 128,
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 128, "recommended": 256 },
"web": "none",
"conditional": false
}
]
}
}
{
"response": {
"valid": false,
"issues": [
{ "path": "category", "code": "invalid_category", "message": "category must be one of the template categories" },
{ "path": "services.app.env.LD_PRELOAD", "code": "forbidden_env", "message": "This variable is controlled by the platform" }
],
"required_plan": null,
"ram_min_total": null,
"services": []
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
VALIDATION_ERROR: O corpo não tem o campomanifest(400).API_KEY_SCOPE_DENIED: A chave de API não tem o escopotemplates:read(403).RATE_LIMIT_EXCEEDED: Requisições demais (429).INTERNAL_SERVER_ERROR: Falha inesperada (500).
{
"code": "VALIDATION_ERROR"
}
Última modificação em 28 de outubro de 2026