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 }
]
}
Plantillas
Listar categorías de plantillas
Devuelve las categorías de plantillas con el número de plantillas de cada una, para que una galería pueda mostrar filtros y contadores.
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 }
]
}
Devuelve cada categoría del catálogo de plantillas con cuántas plantillas públicas contiene. La llamada no necesita autenticación. Con una sesión o una clave de API (scope
templates:read), los contadores incluyen también tus plantillas privadas; una petición con cabecera Authorization siempre se valida, así que una clave no válida devuelve 401. Las lecturas están limitadas a 60 peticiones por minuto y cliente.
string
Cuenta también las plantillas privadas de ese workspace. Pueden usarlo el propietario del workspace y los miembros que pueden leer sus aplicaciones.
Response
object[]
Un array con un elemento por categoría.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
La categoría:
automation, ai-agents, bots, apis, cms, monitoring, starters, databases u other.integer
El número de plantillas de la categoría. Usa el mismo valor de
category en Listar plantillas para abrirla.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 }
]
}
Error Responses
string
El código de error que indica el motivo del fallo. Valores posibles:
VALIDATION_ERROR:workspace_idno es un ID válido (400).API_KEY_SCOPE_DENIED: La clave de API no tiene el scopetemplates:read(403).WORKSPACE_NOT_FOUND: El workspace no existe o no formas parte de él (404).RATE_LIMIT_EXCEEDED: Demasiadas peticiones (429).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "VALIDATION_ERROR"
}
Última modificación el 28 de octubre de 2026