> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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.

**workspace\_id** `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

**response** `object[]`

Un array con un elemento por categoría.

**Mostrar objeto**

**category** `string`

La categoría: `automation`, `ai-agents`, `bots`, `apis`, `cms`, `monitoring`, `starters`, `databases` u `other`.

**count** `integer`

El número de plantillas de la categoría. Usa el mismo valor de `category` en [Listar plantillas](https://docs.vertracloud.app/es-es/api-reference/endpoint/templates/list.md) para abrirla.

```bash cURL theme={null}
curl https://api.vertracloud.app/v1/templates/categories
```

```json Response theme={null}
{
  "response": [
    { "category": "automation", "count": 6 },
    { "category": "ai-agents", "count": 4 },
    { "category": "bots", "count": 3 },
    { "category": "cms", "count": 2 }
  ]
}
```

### Error Responses

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `VALIDATION_ERROR`: `workspace_id` no es un ID válido (`400`).
* `API_KEY_SCOPE_DENIED`: La clave de API no tiene el scope `templates: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`).

```json Error Response theme={null}
{
  "code": "VALIDATION_ERROR"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.