curl https://api.vertracloud.app/v1/templates/categories
{
"response": [
{ "category": "automation", "count": 6 },
{ "category": "ai-agents", "count": 4 },
{ "category": "bots", "count": 3 },
{ "category": "cms", "count": 2 }
]
}
Templates
Listar categorias de templates
Retorna as categorias de templates com o número de templates em cada uma, para que uma galeria mostre filtros e contagens.
GET
/
v1
/
templates
/
categories
curl https://api.vertracloud.app/v1/templates/categories
{
"response": [
{ "category": "automation", "count": 6 },
{ "category": "ai-agents", "count": 4 },
{ "category": "bots", "count": 3 },
{ "category": "cms", "count": 2 }
]
}
Retorna cada categoria do catálogo de templates com quantos templates públicos ela tem. A chamada não precisa de autenticação. Com uma sessão ou uma chave de API (escopo
templates:read), as contagens também incluem os seus templates privados; uma requisição com header Authorization é sempre validada, então uma chave inválida resulta em 401. As leituras são limitadas a 60 requisições por minuto por cliente.
string
Também conta os templates privados desse workspace. O dono do workspace e os membros que podem ler os apps dele podem usá-lo.
Resposta
object[]
Um array com um item por categoria.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
A categoria:
automation, ai-agents, bots, apis, cms, monitoring, starters, databases ou other.integer
O número de templates na categoria. Use o mesmo valor de
category em Listar templates para abri-la.curl https://api.vertracloud.app/v1/templates/categories
{
"response": [
{ "category": "automation", "count": 6 },
{ "category": "ai-agents", "count": 4 },
{ "category": "bots", "count": 3 },
{ "category": "cms", "count": 2 }
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
VALIDATION_ERROR:workspace_idnão é um ID válido (400).API_KEY_SCOPE_DENIED: A chave de API não tem o escopotemplates:read(403).WORKSPACE_NOT_FOUND: O workspace não existe ou você não faz parte dele (404).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