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

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.

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

**response** `object[]`

Um array com um item por categoria.

**Mostrar objeto**

**category** `string`

A categoria: `automation`, `ai-agents`, `bots`, `apis`, `cms`, `monitoring`, `starters`, `databases` ou `other`.

**count** `integer`

O número de templates na categoria. Use o mesmo valor de `category` em [Listar templates](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/list.md) para abri-la.

```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 }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `VALIDATION_ERROR`: `workspace_id` não é um ID válido (`400`).
* `API_KEY_SCOPE_DENIED`: A chave de API não tem o escopo `templates: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`).

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


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